SetupDiInstallClassExA 関数 (setupapi.h)

[アーティクル]
11/20/2024

SetupDiInstallClassEx 関数は、クラスインストーラーまたはインターフェイスクラスをインストールします。

構文

WINSETUPAPI BOOL SetupDiInstallClassExA(
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      InfFileName,
  [in]           DWORD      Flags,
  [in, optional] HSPFILEQ   FileQueue,
  [in, optional] const GUID *InterfaceClassGuid,
                 PVOID      Reserved1,
                 PVOID      Reserved2
);

パラメーター

[in, optional] hwndParent

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

[in, optional] InfFileName

INF ファイルの名前を含む NULL で終わる文字列へのポインター。このパラメーターは省略可能であり、NULLできます。この関数を使用してクラスインストーラーをインストールする場合、INF ファイルには INF ClassInstall32 セクションが含まれており、このパラメーターは NULLすることはできません。

この関数を使用してインターフェイスクラスをインストールする場合、INF ファイルにはINF InterfaceInstall32 セクションが含まれます。

[in] Flags

インストールプロセスを制御する DWORD 型の値。 Flags には、次の値の 0 またはビットごとの OR を指定できます。

DI_NOVCP

FileQueue 指定されている場合は、このフラグを設定します。

DI_NOVCPは、SetupInstallFromInfSection 関数に、独自のキューを作成せず、代わりに呼び出し元が指定したキューを使用するように指示します。

このフラグが設定されている場合、ファイルはキューに入っただけではコピーされません。

SetupInstallFromInfSection 関数の詳細については、Microsoft Windows SDK のドキュメントを参照してください。

DI_NOBROWSE

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

DI_FORCECOPY

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

DI_QUIETINSTALL

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

[in, optional] FileQueue

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

[in, optional] InterfaceClassGuid

インストールするインターフェイスクラスを識別する GUID へのポインター。このパラメーターは省略可能であり、NULLできます。このパラメーターを指定した場合、この関数は GUID で表されるインターフェイスクラスをインストールするために使用されます。このパラメーターが NULL場合、この関数はクラスインストーラーのインストールに使用されます。

Reserved1

引っ込み思案。 0 にする必要があります。

Reserved2

引っ込み思案。 0 にする必要があります。

戻り値

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

備考

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

SetupDiInstallClassEx は、通常、新しいデバイスセットアップクラスまたは新しいデバイスインターフェイスクラスをインストールするためにクラスインストーラーによって呼び出されます。

注デバイスのデバイスインターフェイスをインストールするために、SetupDiInstallDeviceInterfaces を呼び出すことによって、インターフェイスクラスを自動的にインストールすることもできます。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
ターゲットプラットフォームの	デスクトップ
ヘッダー	setupapi.h (Setupapi.h を含む)
ライブラリ	Setupapi.lib

次の方法で共有