Share via

CoFreeLibrary

  • Article

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

void CoFreeLibrary(
  HINSTANCE hInst
);

Parameters

  • 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.

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

CoFreeUnusedLibraries | CoLoadLibrary

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.