NPA_Unregister_Module

Deregisters all instances of an NWPA module.

Thread Context:Non-Blocking
Requirements:This function should only be called with intent to remove the module's code image from server memory.

Syntax

    LONG NPA_Unregister_Module (
       LONG   npaHandle,
       LONG   novellAssignedModuleID
       );

Parameters

npaHandle
The CDM's or HAM's handle for using the NPA APIs, assigned during NPA_Register_CDM_Module or NPA_Register_HAM_Module, respectively.
novellAssignedModuleID
Unique ID for the module to be deregistered. This ID is assigned by Developer Services to a specific module upon request from the vendor.

Return Values

The following table lists return values and descriptions.

zero

Successful

nonzero

Unsuccessful

Remarks

NPA_Unregister_Module is used to deregister the CDM or HAM, along with its respective entry points, from NWPA. The intent of this function is prepare the module for having its code image removed from server memory. NPA_Unregister_Module should be called within the context of the module's exit function (CDM_Unload or HAM_Unload).

WARNING:NPA_Unregister_Module will deregister all instances of this module and abort all pending I/O for this HAM. If other instances are to remain active, do not call this function. Call Instance Unload to unload a single instance (see Section 3.12, Instance Unload for HAMs).