Novell Documentation: NLM & NetWare Libraries for C

NWAttachToFileServerByConn

Attaches to a NetWare server through a service identified by a connection.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Server Environment

Syntax

  #include <nwserver.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API NWAttachToFileServerByConn (
     NWCONN_HANDLE         conn,  
     const nstr8 N_FAR    *serverName,  
     nuint16               scopeFlag,  
     NWCONN_HANDLE N_FAR  *newConnID);

Delphi Syntax

  uses calwin32 
   
  Function NWAttachToFileServerByConn 
    (conn : NWCONN_HANDLE; 
     const serverName : pnstr8; 
     scopeFlag : nuint16; 
     Var newConnID : NWCONN_HANDLE 
  ) : NWCCODE;

Parameters

conn: (IN) Specifies the NetWare server connection handle through which to attach.
serverName: (IN) Points to a 48-character buffer for the server name (optional).
scopeFlag: (IN) Reserved for Novell use only; must be 0.
newConnID: (OUT) Points to the connection handle, if any, to serverName.

Return Values

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

0x0000	SUCCESSFUL
0x8800	ALREADY_ATTACHED
0x8801	INVALID_CONNECTION
0x8847	NO_SERVER_ERROR
0x890A	NLM_INVALID_CONNECTION
0x89FC	UNKNOWN_FILE_SERVER

Remarks

NWAttachToFileServerByConn allows attachments to servers not seen by the preferred server.

NCP Calls