NWPSCfgGetFirstNServer(3nw)


NWPSCfgGetFirstNServer -- finds first NetWare server in list maintained by print server

Synopsis

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

NWCCODE NWAPI NWPSCfgGetFirstNServer (WORD connType, DWORD connID, char NWFAR *pServerName, NWPSListHandle NWFAR *handle, char NWFAR *nServerName);

Description

The parameters are as follows:

connType
(IN) Specifies either NWPS_BINDERY_SERVICE or NWPS_BINDERY_SERVICE_PRE_40.

connID
(IN) Specifies the connection identifier.

pServerName
(IN) Points to the name of the print server.

handle
(OUT) Points to the value to be passed to NWPSCfgGetNextNServer and NWPSCfgEndNextNServer.

nServerName
(OUT) Points to the name of the first NetWare server found. Its maximum length is 48 characters including NULL termination.

Return values

0x0000
Successful

-1
General Error

other
Bindery Error

Notices

Memory allocated and files opened by NWPSCfgGetFirstNServer must be respectively deallocated and closed by calling NWPSCfgEndNextNServer. If the completion code is non-zero, the value returned for the handle is zero, and calling NWPSCfgEndNextNServer is not required.

Services

Print Server

References

NWPSCfgEndNextNServer(3nw), NWPSCfgGetNextNServer(3nw), NWPSCfgVerifyNServer(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.