NWGetKnownServersInfo(3nw)


NWGetKnownServersInfo -- returns information about servers advertising themselves to the server with SAP packets

Synopsis

   #include <nwfse.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWGetKnownServersInfo (NWCONN_HANDLE conn, nuint32 startNum, nuint32 serverType, NWFSE_KNOWN_SERVER_INFO N_FAR * fseKnownServerInfo);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

startNum
(IN) Specifies the cumulative number of servers returned from all previous calls; normally, zero (0) for the first call.

serverType
(OUT) Receives the server type: 0x0400 = NetWare server; 0xFFFF = All Types Of Servers.

fseKnownServerInfo
(OUT) Points to NWFSE_KNOWN_SERVER_INFO containing known server information.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x897E
NCP_BOUNDARY_CHECK_FAILED

0x89C6
NO_CONSOLE_PRIVILEGES

Notices

To call NWGetKnownServersInfo, you must have console operator rights.

startNum should be set to zero on the first call. On subsequent calls, the value returned in the numberOfEntries field in the SERVER_AND_VCONSOLE_INFO structure should be added to the value in startNum until INVALID_CONNECTION is returned.

Services

File Server Environment

NCP calls

0x2222 123 56
Get Known Servers Information

References

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