Share via


CoFreeLibrary

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

void CoFreeLibrary(
  HINSTANCE hInst
); 

Parameters

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

Return Value

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 later versions, 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.

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

Requirements

Header objbase.h
Library ole32.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CoFreeUnusedLibraries
CoLoadLibrary