CoLoadLibrary 関数 (objbase.h)

呼び出し元のプロセスに特定の DLL を読み込みます。

CoLoadLibrary は LoadLibraryEx と同じです。 CoLoadLibrary は、ライブラリの有効期間には影響しません。

構文

HINSTANCE CoLoadLibrary(
  [in] LPOLESTR lpszLibName,
  [in] BOOL     bAutoFree
);

パラメーター

[in] lpszLibName

読み込むライブラリの名前。

[in] bAutoFree

このパラメーターは、16 ビット アプリケーションとの互換性のために保持されますが、無視されます。

戻り値

関数が成功した場合、戻り値は読み込まれたライブラリへのハンドルです。それ以外の場合は NULL です。

注釈

CoGetClassObject 関数は CoLoadLibrary を呼び出しません。 CoLoadLibrary は 、 lpszLibName パラメーターで指定された DLL を 、CoGetClassObject を呼び出したプロセスに読み込みます。 コンテナーは CoLoadLibrary を直接呼び出さないでください。

内部的には、 CoLoadLibrary を使用してカウントをインクリメントし、 CoFreeLibrary 関数を使用してカウントをデクリメントすることで、読み込まれた DLL に参照カウントが保持されます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	objbase.h
Library	Ole32.lib
[DLL]	Ole32.dll
API セット	ext-ms-win-com-ole32-l1-1-5 (Windows 10 バージョン 10.0.15063 で導入)

こちらもご覧ください

CoFreeAllLibraries

CoFreeLibrary

CoFreeUnusedLibraries

CoFreeUnusedLibrariesEx