Determines whether the DLL that implements this function is in use. If not, the caller can unload the DLL from memory.
OLE does not provide this function. DLLs that support the OLE Component Object Model (COM) should implement and export DllCanUnloadNow.
HRESULT DllCanUnloadNow( );
This function has no parameters.
If the function succeeds, the return value is S_OK. Otherwise, it is S_FALSE.
A call to DllCanUnloadNow determines whether the DLL from which it is exported is still in use. A DLL is no longer in use when it is not managing any existing objects (the reference count on all of its objects is 0).CoFreeUnusedLibraries function. When it returns S_OK, CoFreeUnusedLibraries frees the DLL. CoGetClassObject function. (You also need to implement and export the DllGetClassObject function in the same DLL).
DllCanUnloadNow should return S_FALSE if there are any existing references to objects that the DLL manages.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||combaseapi.h (include Objbase.h)|