Share via


CoFreeUnusedLibraries (Compact 2013)

3/26/2014

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

Syntax

void CoFreeUnusedLibraries();

Parameters

None.

Return Value

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

Header

objbase.h

Library

ole32.lib

See Also

Reference

COM Functions
CoLoadLibrary
DllCanUnloadNow