NWGetFileServerDescription

Returns information about a NetWare server, including company name, NetWare version, revision date and copyright notice, using descriptive strings.

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  NWGetFileServerDescription  ( 
     NWCONN_HANDLE   conn,  
     pnstr8          companyName,  
     pnstr8          revision,  
     pnstr8          revisionDate,  
     pnstr8          copyrightNotice);

Delphi Syntax

  uses calwin32 
   
  Function NWGetFileServerDescription 
    (conn : NWCONN_HANDLE; 
     companyName : pnstr8; 
     revision : pnstr8; 
     revisionDate : pnstr8; 
     copyrightNotice : pnstr8 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
companyName
(OUT) Points to the name of the company providing the version of NetWare (80 characters, optional).
revision
(OUT) Points to the NetWare version and revision description string (80 characters, optional).
revisionDate
(OUT) Points to the revision date in the form xx/xx/xx. For example: 12/16/91 (24 characters, optional).
copyrightNotice
(OUT) Points to the copyright notice (80 characters, optional).

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8996

SERVER_OUT_OF_MEMORY

Remarks

Under NETX, if an invalid connection handle is passed to conn, NWGetFileServerDescription will return 0x0000. NETX will pick a default connection handle if the connection handle cannot be resolved.

Each string is NULL-terminated.

For items not desired in the return, substitute NULL. However, all parameter positions must be filled.

Any client attached to the specified server can call NWGetFileServerDescription. Console operator rights are not required.

NCP Calls