DllInstall 関数 (shlwapi.h)

DLL のインストールとセットアップを処理します。

構文

HRESULT DllInstall(
                 BOOL   bInstall,
  [in, optional] PCWSTR pszCmdLine
);

パラメーター

bInstall

種類: BOOL

DLL がインストールされている場合は TRUE。 アンインストール 中の場合は FALSE。

[in, optional] pszCmdLine

種類: PCWSTR

使用するセットアップ手順を示す regsvr32 によって渡される文字列。 この値には NULL を指定できます。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数は、アプリケーションのインストールまたはセットアップ中に使用するために、DLL によって名前で実装およびエクスポートできます。 レジストリに情報を追加するなどのタスクを DLL が実行できるように、 regsvr32 によって呼び出されます。

DllInstall は、アプリケーションのインストールとセットアップにのみ使用されます。 アプリケーションで呼び出さないでください。 これは、 目的が DllRegisterServer または DllUnregisterServer に似ています。 これらの関数とは異なり、 DllInstall はさまざまなアクションを指定するために使用できる入力文字列を受け取ります。 これにより、適切な条件に基づいて、DLL を複数の方法でインストールできます。

regsvr32 で DllInstall を使用するには、"/i" フラグの後にコロン (:)と文字列を追加します。 文字列は、pszCmdLine パラメーターとして DllInstall に渡されます。 コロンと文字列を省略すると、 pszCmdLine は NULL に設定されます。 次の例は、DLL をインストールするために使用します。

regsvr32 /i:"Install_1" dllname.dll

DllInstall は 、bInstall を TRUE に設定し、 pszCmdLine を "Install_1" に設定して呼び出されます。 DLL をアンインストールするには、次の手順に従います。

regsvr32 /u /i:"Install_1" dllname.dll

上記の両方の例では、 DllRegisterServer または DllUnregisterServer も呼び出されます。 DllInstall のみを呼び出すには、"/n" フラグを追加します。

regsvr32 /n /i:"Install_1" dllname.dll

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
[DLL]	Shlwapi.dll (バージョン 4.71 以降)