NWCCGetConnInfo

Returns information about the specified connection

NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform Client (CLX*.*)
Service:Connection

Syntax

C

  #include <nwclxcon.h> 
   
  N_EXTERN_LIBRARY NWRCODE NWCCGetConnInfo  ( 
     NWCONN_HANDLE   connHandle,  
     nuint           infoType,  
     nuint           len, 
     nptr            buffer);
  

Delphi

  uses clxwin32 
   
  Function NWCCGetConnInfo 
    (connHandle : NWCONN_HANDLE;                
     infoType : nuint;  
     len : nuint;                  
     buffer : nptr               
  ) : NWRCODE; 
  

Parameters

connHandle
(IN) Specifies the connection handle for which to return information.
infoType
(IN) Specifies the information to be returned about the connection specified in the connHandle parameter (see Section 5.4, infoType Parameter Values). NOTE: Do not pass NWCC_INFO_RETURN_ALL (see "Remarks" below).
len
(IN) Specifies the length of the information buffer to be returned.
buffer
(OUT) Points to a buffer containing the returned information.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESS

0x8801

NWE_CONN_INVALID

0x8868

NWE_STRING_TRANSLATION

0x8869

NWE_ACCESS_VIOLATION

0x886B

NWE_INVALID_LEVEL

0x890A

NLM_INVALID_CONNECTION

Remarks

NWCCGetConnInfo returns a single piece of connection information for the specified connection. It is important that the size of the buffer parameter is large enough to contain the requested information.

If the infoType parameter is invalid, NWE_INVALID_LEVEL will be returned. If the infoType parameter is set to NWCC_INFO_TRAN_ADDR, NWCCGetConnInfo will use the NWCCTranAddr structure (see Section 5.4, infoType Parameter Values).

NOTE:Do not pass NWCC_INFO_RETURN_ALL for the infoType parameter. NWCCGetConnInfo fails on that value and returns NWE_INVALID_LEVEL. To obtain all information about a connection, call NWCCGetAllConnInfo.

See