NWCCGetConnRefInfo

Returns the specified information for a given 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 NWCCGetConnRefInfo ( 
     nuint32   connRef,  
     nuint     infoType,  
     nuint     len,  
     nptr      buffer);
  

Delphi

  uses clxwin32 
   
  Function NWCCGetConnRefInfo 
    (connRef : nuint32;                        
     infoType : nuint;                           
     len : nuint;                             
     buffer : nptr                              
  ) : NWRCODE;
  

Parameters

connRef
(IN) Specifies the connection reference for which to return the specified information.
infoType
(IN) Specifies the information to be returned about the connection (see Section 5.4, infoType Parameter Values).
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

0x880E

NWE_BUFFER_OVERFLOW

0x8864

NWE_INVALID_MATCH_DATA

0x8865

NWE_MATCH_FAILED

0x8866

NWE_NO_MORE_ENTRIES

0x8868

NWE_STRING_TRANSLATION

0x8869

NWE_ACCESS_VIOLATION

0x886B

NWE_INVALID_LEVEL

0x886C

NWE_RESOURCE_LOCK

0x890A

NLM_INVALID_CONNECTION

Remarks

NWCCGetConnRefInfo returns connection information from the NWCCConnInfo structure associated with the given connection. NWCCGetConnRefInfo can either be set to return one field of the structure or the entire structure itself.

buffer must point to a buffer of the type of information being requested. (The return type is noted below for cache information.)

If the infoType parameter is invalid, NWE_INVALID_LEVEL will be returned. See Section 5.4, infoType Parameter Values.

If the infoType parameter is set to NWCC_INFO_TRAN_ADDR, NWCCGetConnRefInfo will use the NWCCTranAddr structure.

See