NWCCGetPrimConnRef

Returns the primary connection reference

NetWare Server: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 NWCCGetPrimConnRef ( 
     pnuint32   connRef);

Delphi

  uses clxwin32 
   
  Function NWCCGetPrimConnRef 
    (connRef : pnuint32                            
  ) : NWRCODE;

Parameters

connRef
(OUT) Points to the primary connection reference of the workstation.

Return Values

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

0x0000

SUCCESS

Remarks

The primary connection identifies the server to which the user originally logged in. For NDS, the primary connection reference is the connection with the writeable replica used during the login process.

If NWCCGetPrimConnRef is called on the NLM platform, NWE_FUNCTION_INVALID will be returned.