NWGetConnInformation(3nw)
NWGetConnInformation --
returns connection information
Synopsis
#include <nwconnec.h>
NWCCODE N_API NWGetConnInformation(
NWCONN_HANDLE conn,
nuint infoLevel,
nuint infoLen,
nptr connInfo);
Description
The parameters are as follows:
- conn
-
(IN) Indicates the connection to get information on.
- infoLevel
-
IN) Indicates the information to be returned.
- infoLen
-
(IN) Indicates the length of the information buffer to be returned.
- connInfo
-
(OUT) Points to NWCConnInfo containing the requested information.
Return values
- 0x0000
-
SUCCESSFUL
- 0x8801
-
INVALID_CONNECTION
- 0x880E
-
BUFFER_OVERFLOW
Level Not Supported
Notices
NWGetConnInformation will return one piece of information or
the entire structure. You must fill in the pointer to valid data for
the requester to copy the information into. Substitute a NULL
pointer for the information you do not want returned, and the requester
will skip that entry.
infoLevel can have the following values:
NWC_CONN_INFO_INFO_VERSION 0x0001
NWC_CONN_INFO_AUTH_STATE 0x0002
NWC_CONN_INFO_BCAST_STATE 0x0003
NWC_CONN_INFO_CONN_REF 0x0004
NWC_CONN_INFO_TREE_NAME 0x0005
NWC_CONN_INFO_WORKGROUP_ID 0x0006
NWC_CONN_INFO_SECURITY_STATE 0x0007
NWC_CONN_INFO_CONN_NUMBER 0x0008
NWC_CONN_INFO_USER_ID 0x0009
NWC_CONN_INFO_SERVER_NAME 0x000A
NWC_CONN_INFO_TRAN_ADDR 0x000B
NWC_CONN_INFO_NDS_STATE 0x000C
NWC_CONN_INFO_MAX_PACKET_SIZE 0x000D
NWC_CONN_INFO_LICENSE_STATE 0x000E
NWC_CONN_INFO_PUBLIC_STATE 0x000F
NWC_CONN_INFO_SERVICE_TYPE 0x0010
NWC_CONN_INFO_DISTANCE 0x0011
NWC_CONN_INFO_RETURN_ALL 0xFFFF
If you only request one piece of information, connInfo points
to a buffer containing the type of information requested.
Services
Connection
NCP calls
- 0x2222 23 17
-
Get File Server Information
- 0x2222 23 22
-
Get Station's Logged Info (old)
- 0x2222 23 28
-
Get Station's Logged Info
- 0x2222 104 1
-
Ping for NDS NCP
References
NWScanConnInformation(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.