NWAttachToFileServer

Attaches to the specified NetWare server.

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 NWAttachToFileServer (
     const nstr8 N_FAR    *serverName,  
     nuint16               scopeFlag,  
     NWCONN_HANDLE N_FAR  *newConnID);

Delphi Syntax

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

Parameters

serverName
(IN) Points to the name of the server to connect.
scopeFlag
Is reserved; must be 0.
newConnID
(OUT) Points to the new connection handle, if the attachment was successful.

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

0x89FF

NO_RESPONSE_FROM_SERVER

Remarks

WARNING:Before attaching to the specified server, NWAttachToFileServer tries to get the server’s net address from the default server’s Bindery.

NO_RESPONSE_FROM_SERVER will be returned if RIP traffic is filtered on a router but SAP traffic is not. The dynamic object can be read from the bindery, but the request to attach to a server cannot be routed

NCP Calls