6.7 WFMReleaseDLL

HRESULT WFMReleaseDLL( hProvider )

Notifies the XFS Manager that the service provider is available to be unloaded from memory.

Parameters HPROVIDER hProvider

Handle to the service provider, obtained from the XFS Manager in the WFPOpen call.

Comments This function initiates the process in which the service provider is unloaded from memory by the XFS Manager. However, note that the Manager must issue the WFPUnloadService function to the service provider before it actually unloads the service provider DLL. The recommended procedure is as follows:

• The service provider finishes processing the WFPClose for its last open session

• The SP does appropriate cleanup (deallocating memory, killing separate threads, etc.)

• The SP posts the WFS_CLOSE_COMPLETE message for the final close

• The SP calls WFMReleaseDLL, and after the return from this call, does nothing other than return from the procedure that called WFMReleaseDLL

• The XFS Manager calls WFPUnloadService, verifying that the SP is in fact still ready to be unloaded

• If the SP says OK, the XFS Manager unloads the SP DLL

Error Codes If the function return is not WFS_SUCCESS, it is the following error condition:

WFS_ERR_INVALID_HPROVIDER

The hProvider parameter is not a valid provider handle.