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 に参照カウントが保持されます。

要件

こちらもご覧ください

CoFreeAllLibraries

CoFreeLibrary

CoFreeUnusedLibraries

CoFreeUnusedLibrariesEx