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.