NWPSComPrintServerRequest(3nw)


NWPSComPrintServerRequest -- transmits request packet to print server

Synopsis

   #include <nwps_com.h> 
   or 
   #include <nwpsrv.h> 
   

NWCCODE NWAPI NWPSComPrintServerRequest (WORD spxID, void NWPTR reqBuffer, int reqSize, void NWPTR repBuffer, int repSize);

Description

The parameters are as follows:

spxID
(IN) Specifies the SPX connection to the print server.

reqBuffer
(IN) Points to the address of the request packet buffer.

reqSize
(IN) Specifies the length of the request packet.

repBuffer
(OUT) Points to the address of the reply packet buffer.

repSize
(OUT) Receives the length of the expected reply.

Return values

0x0000
NWPSE_SUCCESSFUL

0x00ED
NWPSE_CONNECTION_TERMINATED

Notices

NWPSComPrintServerRequest allows for expansion of the supported services without adding more calls to nwps_com.h.

reqBuffer contains the request, formated as indicated in nwps_pkt.h. When the last data item in the packet is a zero-terminated ASCII string, only the length of the packet up to and including the zero needs to be specified for reqSize.

repBuffer need only be as large as repSize. The data returned from the print server is the full size of the packet described in nwps_pkt.h, but only the amount of data specified by repSize is copied into the caller's repBuffer.

An NWPSE_SUCCESSFUL return code indicates a reply was received for the request. If this is the case, the user must check the reply packet's returnCode. This field may contain errors from the print server ranging from 0x100 to 0x600, depending on the nature of the problem.

Services

Print Server

NCP calls

None
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.