CoFreeLibrary

This function frees a library that, when loaded, was specified to be freed explicitly.

At a Glance

Syntax

void CoFreeLibrary(HINSTANCE hInst);

Parameter

hInst

[in] Handle to the library module to be freed, as returned by CoLoadLibrary.

Return Values

None.

Remarks

The CoFreeLibrary function should be called to free a library that is to be freed explicitly. This is established when the library is loaded with the bAutoFree parameter of CoLoadLibrary set to FALSE. It is illegal to free a library explicitly when the corresponding CoLoadLibrary call specifies that it be freed automatically (the bAutoFree parameter is set to TRUE).

For Windows CE versions 2.10 and later, this function is not supported. Applications should call CoFreeUnusedLibraries instead.

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