GetFileServerID

Returns the server ID of the specified server

Local Servers:nonblocking
Remote Servers:nonblocking
Classification:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Service:Server-Based Connection

Syntax

  #include <nwconn.h>  
   
  int GetFileServerID (  
     char   *fileServerName,  
     WORD   *fileServerID);

Parameters

fileServerName
(IN) Specifies the name of the server (maximum 48 characters) for which fileServerID is returned.
fileServerID
(OUT) Receives the server number.

Return Values

The following table lists return values and descriptions.

Value

Hex

Name

Description

0

 

ESUCCESS

 

252

(0xFC)

UNKNOWN_FILE_SERVER

Not attached to the specified server (it is not necessary to be logged in).

Remarks

The GetFileServerID function returns the file server ID of a server by passing the fileServerName, a NULL-terminated string.

If the NLM is not logged in to the named server, fileServerID receives a value of -1.

See Also

GetDefaultFileServerID