NWSMLoadNLM

Loads a selected NLM on a server

NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Server Management

Syntax

  #include <nwsm.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY NWCCODE NWSMLoadNLM (
     NWCONN_HANDLE        connHandle,  
     const nstr8 N_FAR   *loadCommand); 
  

Delphi Syntax

  uses calwin32 
   
  Function NWSMLoadNLM 
    (connHandle : NWCONN_HANDLE; 
     loadCommand : pnstr8 
  ) : NWCCODE; 
  

Parameters

connHandle
(IN) Specifies the server connection handle which is being managed.
loadCommand
(IN) Points to the load command for the NLM. It must be NULL terminated; maximum length is 482 bytes.

Return Values

These are common return values; see Return Values (NDK: Connection, Message, and NCP Extensions)for more information.

0x0000

SUCCESS

0x0202

Unable to load specified module

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x88FB

ERR_NCP_NOT_SUPPORTED

0x899E

INVALID_FILENAME

Remarks

You must be logged in with the connection specified by connHandle, be permanently authenticated, and have supervisor rights to call NWSMLoadNLM.

loadCommand can be any string that is valid for the LOAD command on the console (except it does not include the actual "LOAD" command). It contains the NLM name (including the path if it is not in the server path), and command line parameters if any.

The LOAD command has the following format:

  {VOLUME NAME:}{PATH\...}NLMname{.ext}{parameters}
  

NWSMLoadNLM does not support UNC paths.

The NLM does not have to include the extensions. .NLM will be assumed if the extensions are not included.

The server console LOAD command is documented in the NetWare server utilities documentation.

NCP Calls

See Also

NWSMUnloadNLM