CoFreeUnusedLibraries

  • Article

This function unloads any DLLs that are no longer in use and that, when loaded, were specified to be freed automatically.

void CoFreeUnusedLibraries();

Parameters

None.

Return Values

None.

Remarks

Applications can call CoFreeUnusedLibraries periodically to free resources. It is most efficient to call it either at the top of a message loop or in some idle-time task. DLLs that are to be freed automatically have been loaded with the bAutoFree parameter of the CoLoadLibrary function set to TRUE. CoFreeUnusedLibraries internally calls DllCanUnloadNow for DLLs that implement and export that function.

Passing into this function any invalid and, under some circumstances, NULL pointers results in unexpected termination of the application.

To determine whether the platform supports this function, see Determining Supported COM APIs.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Objbase.h.
Link Library: Ole32.lib.

See Also

CoLoadLibrary | DllCanUnloadNow

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.