The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CoLoadLibrary function

Loads a specific DLL into the caller's process.

CoLoadLibrary is equivalent to LoadLibraryEx. CoLoadLibrary does not affect the lifetime of the library.

Syntax

C++


HINSTANCE CoLoadLibrary(
  _In_ LPOLESTR lpszLibName,
  _In_ BOOL     bAutoFree
);

Parameters

lpszLibName [in]: The name of the library to be loaded.
bAutoFree [in]: This parameter is maintained for compatibility with 16-bit applications, but is ignored.

Return value

If the function succeeds, the return value is a handle to the loaded library; otherwise, it is NULL.

Remarks

The CoGetClassObject function does not call CoLoadLibrary. CoLoadLibrary loads a DLL specified by the lpszLibName parameter into the process that called CoGetClassObject. Containers should not call CoLoadLibrary directly.

Internally, a reference count is kept on the loaded DLL by using CoLoadLibrary to increment the count and the CoFreeLibrary function to decrement it.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Objbase.h
Library	Ole32.lib
DLL	Ole32.dll