NWGetNLMInfo

Returns information about a specific loaded NLM.

Local Servers:blocking
Remote Servers:blocking
NetWare Server: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 <nwfse.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWGetNLMInfo  ( 
     NWCONN_HANDLE            conn,  
     nuint32                  NLMNum,  
     pnstr8                   fileName,  
     pnstr8                   NLMname,  
     pnstr8                   copyright,  
     NWFSE_NLM_INFO  N_FAR   *fseNLMInfo);

Delphi Syntax

  uses calwin32 
   
  Function NWGetNLMInfo 
    (conn : NWCONN_HANDLE; 
     NLMNum : nuint32; 
     fileName : pnstr8; 
     NLMname : pnstr8; 
     copyright : pnstr8; 
     Var fseNLMInfo : NWFSE_NLM_INFO 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
NLMNum
(IN) Specifies the NLM ID number returned by NWGetNLMLoadedList.
fileName
(OUT) Points to the name of the NLM file.
NLMName
(OUT) Points to a short description of the NLM.
copyright
(OUT) Points to the copyright string (optional).
fseNLMInfo
(OUT) Points to NWFSE_NLM_INFO.

Return Values

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

0x0000

SUCCESSFUL

0x897E

NCP_BOUNDARY_CHECK_FAILED

0x89C6

NO_CONSOLE_PRIVILEGES

0x89FF

Failure or Invalid NLM Number

Remarks

To call NWGetNLMInfo, you must have console operator rights.

NWGetNLMInfo should only be called for NLMs that have information in the buffer.

NCP Calls

See Also

NWGetNLMLoadedList, NWGetNLMsResourceTagList