NWSMUnloadNLM

Unloads 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 NWSMUnloadNLM (
     NWCONN_HANDLE        connHandle,  
     const nstr8 N_FAR   *NLMName);

Delphi Syntax

  uses calwin32 
   
  Function NWSMUnloadNLM 
    (connHandle : NWCONN_HANDLE; 
     NLMName : pnstr8 
  ) : NWCCODE;

Parameters

connHandle
(IN) Specifies the server connection handle which is being managed.
NLMName
(IN) Points to the name of the NLM to be unloaded (NULL-terminated with a maximum length of 482 bytes).

Return Values

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

0x0000

SUCCESS

0x009E

Bad file name or no file name given

0x0202

Unable to unload specified module

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89FB

ERR_NCP_NOT_SUPPORTED

0x899E

INVALID_FILENAME

Remarks

You must be logged into connHandle, be permanently authenticated, and have supervisor rights to call NWSMUnloadNLM.

The NLMName parameter can be any string that is valid for the UNLOAD command on the console (except it does not include the actual "UNLOAD" command) and contains the NLM name.

The NLMName parameter has the following format:

  NLMname{.ext}

NWSMUnloadNLM does not support UNC paths.

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

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

NOTE:NWSMUnloadNLM can return SUCCESS without unloading the specified NLM application if the NLM also has dependencies loaded. The return of SUCCESS signifies only that the server successfully processed the RPC.

NCP Calls

See Also

NWSMLoadNLM