NWCCGetAllConnRefInfo

Returns all information for a specified connection reference

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 NWCCGetAllConnRefInfo ( 
     nuint32         connRef,  
     nuint           connInfoVersion,  
     pNWCCConnInfo    connInfoBuffer);
  

Delphi

  uses clxwin32 
   
  Function NWCCGetAllConnRefInfo 
    (connRef : nuint32;                          
     connInfoVersion : nuint;                 
     connInfoBuffer : pNWCCConnInfo              
  ) : NWRCODE; 
  

Parameters

connRef
(IN) Specifies the connection reference for which information is to be returned.
connInfoVersion
(IN) Specifies the connection information version (NWCC_INFO_VERSION_1 or higher).
connInfoBuffer
(OUT) Points to the NWCCConnInfo structure 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

0x890A

NLM_INVALID_CONNECTION

Remarks

The connInfoVersion parameter specifies which version of the NWCCConnInfo structure will be used.

If the connInfoVersion parameter is set to NWCC_INFO_VERSION_2 or higher, the tranAddr field of the NWCCConnInfo structure must be set to NULL or initialized.

You must allocate the connInfoBuffer parameter. It will be returned with all the connection information.

See Also

NWGetConnectionInformation, NWGetUserInfo (Server Management)