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
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 |
|
|
Library |
|
|
DLL |
|
See also