SetupDiInstallClassA 関数 (setupapi.h)

[アーティクル]
08/26/2023

SetupDiInstallClass 関数は、指定した INF ファイルの ClassInstall32 セクションをインストールします。

構文

WINSETUPAPI BOOL SetupDiInstallClassA(
  [in, optional] HWND     hwndParent,
  [in]           PCSTR    InfFileName,
  [in]           DWORD    Flags,
  [in, optional] HSPFILEQ FileQueue
);

パラメーター

[in, optional] hwndParent

このクラスのインストールに使用されるすべてのユーザーインターフェイスの親ウィンドウへのハンドル。このパラメーターは省略可能であり、 NULL にすることができます。

[in] InfFileName

INF ClassInstall32 セクションを含む INF ファイルの名前を含む NULL で終わる文字列へのポインター。

[in] Flags

これらのフラグは、インストールプロセスを制御します。次の組み合わせを指定できます。

DI_NOVCP

FileQueue が指定されている場合は、このフラグを設定します。 DI_NOVCPは、SetupInstallFromInfSection 関数 (Microsoft Windows SDKドキュメントで説明) に、独自のキューを作成せず、代わりに呼び出し元が指定したキューを使用するように指示します。このフラグが設定されている場合、ファイルはキューに入っているだけでコピーされません。

DI_NOBROWSE

コピー操作で指定したファイルが見つからない場合に参照を無効にするには、このフラグを設定します。呼び出し元がファイルキューを指定した場合、このフラグは無視されます。

DI_FORCECOPY

ユーザーのコンピューターに既に存在する場合でも、常にファイルをコピーするようにこのフラグを設定します。呼び出し元がファイルキューを指定した場合、このフラグは無視されます。

DI_QUIETINSTALL

絶対に必要でない限り、ユーザーインターフェイスを抑制するには、このフラグを設定します。たとえば、進行状況ダイアログは表示しません。呼び出し元がファイルキューを指定した場合、このフラグは無視されます。

[in, optional] FileQueue

DI_NOVCP フラグが設定されている場合、このパラメーターは、ファイル操作をキューに入れる必要があるがコミットしないファイルキューへのハンドルを提供します。

戻り値

成功した場合、関数は TRUE を 返します。それ以外の場合は FALSE を 返し、ログに記録されたエラーを GetLastError の呼び出しで取得できます。

注釈

この関数の呼び出し元は、Administrators グループのメンバーである必要があります。

この関数は、新しいデバイスクラスのデバイスをインストールするときに、クラスインストーラーによって呼び出されます。

インターフェイスクラスまたはデバイスクラスをインストールするには、 SetupDiInstallClassEx を使用します。

注意

setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupDiInstallClass を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	setupapi.h (Setupapi.h を含む)
Library	Setupapi.lib

こちらもご覧ください

SetupDiCallClassInstaller

SetupDiInstallClassEx