NWFragNCPExtensionRequest

Sends and receives information from an NCP extension handle

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:NCP Extension

Syntax

  #include <nwncpext.h> 
  #include <nwmisc.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API NWFragNCPExtensionRequest ( 
     NWCONN_HANDLE       conn,  
     nuint32             NCPExtensionID,  
     nuint16             reqFragCount,  
     NW_FRAGMENT N_FAR  *reqFragList,  
     nuint16             replyFragCount,  
     NW_FRAGMENT N_FAR  *replyFragList);

Delphi Syntax

  uses calwin32 
   
  Function NWFragNCPExtensionRequest 
    (conn : NWCONN_HANDLE; 
     NCPExtensionID : nuint32; 
     reqFragCount : nuint16; 
     Var reqFragList : NW_FRAGMENT; 
     replyFragCount : nuint16; 
     Var replyFragList : NW_FRAGMENT 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
NCPExtensionID
(IN) Specifies the ID of the NCP extension handler to use for the request.
reqFragCount
(IN) Specifies the number of request fragments.
reqFragList
(IN) Points to the NW_FRAGMENT structure.
replyFragCount
(IN) Specifies the number of reply fragments.
replyFragList
(IN/OUT) Points to the NW_FRAGMENT structure.

Remarks

The fragment based protocol allows data up to 64K (a server imposed limitation) to be transferred to and from the NCP extension handler.

To increase packet efficiency, NWFragNCPExtensionRequest packs as many fragments as possible into a send buffer.

The reply data will be returned in the NW_FRAGMENT structure pointed to by the replyFragList parameter. The fragSize field of the NW_FRAGMENT structure will be updated to reflect the number of bytes copied into the buffer pointed to by the fragAddress field.

NCP Calls