NWCCOpenConnByRef

Opens a connection associated with the 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 NWCCOpenConnByRef ( 
     nuint32           connRef,  
     nuint             openState,  
     nuint             reserved,  
     pNWCONN_HANDLE     pConnHandle);
  

Delphi

  uses clxwin32 
   
  Function NWCCOpenConnByRef 
    (connRef : nuint32;                        
     openState : nuint;                       
     reserved : nuint;                           
     pConnHandle : pNWCONN_HANDLE               
  ) : NWRCODE;
  

Parameters

connRef
(IN) Specifies a reference, which identifies a valid connection.
openState
(IN) Specifies the state of the connection (see Section 5.2, Connection State Values).
reserved
(IN) Reserved for future use (set to NWCC_RESERVED).
pConnHandle
(OUT) Points to the connection handle to be returned.

Return Values

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

0x0000

SUCCESS

0x8801

NWE_CONN_INVALID

0x8836

INVALID_PARAMETER

0x8869

NWE_ACCESS_VIOLATION

0x890A

NLM_INVALID_CONNECTION

Remarks

NWCCScanConnRefs can be called to get the connection reference.

connRef can be used to get information about the connection, but a valid connection handle must be used to make actual requests to the connection.

See Also

NWCCCloseConn, NWCCOpenConnByName, NWCCOpenConnByPref