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.