SetupDiCreateDeviceInfoListExA 関数 (setupapi.h)

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

SetupDiCreateDeviceInfoList 関数は、リモートコンピューターまたはローカルコンピューターに空のデバイス情報セットを作成し、必要に応じてセットをデバイスセットアップクラスに関連付けます。

構文

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

パラメーター

[in, optional] ClassGuid

新しく作成されたデバイス情報セットに関連付けるデバイスセットアップクラスの GUID へのポインター。このパラメーターを指定した場合、このデバイス情報セットに含めることができるのは、このクラスのデバイスだけです。このパラメーターが NULL設定されている場合、デバイス情報セットは特定のデバイスセットアップクラスに関連付けられません。

[in, optional] hwndParent

デバイス固有でないアクション (グローバルクラスドライバーリストを使用するデバイスの選択ダイアログボックスなど) に関連するすべてのユーザーインターフェイスに使用する最上位ウィンドウへのハンドル。このハンドルは省略可能であり、NULLできます。特定の最上位ウィンドウが不要な場合は、hwndParent NULLをに設定します。

[in, optional] MachineName

ネットワーク上のコンピューターの名前を含む NULL で終わる文字列へのポインター。名前を指定すると、そのコンピューター上のデバイスのみを作成し、このデバイス情報セットで開くことができます。このパラメーターが NULLに設定されている場合、デバイス情報セットはローカルコンピューター上のデバイス用です。

注意

この機能は削除されたため、この機能を使用してリモートコンピューターにアクセスすることは、Windows 8 および Windows Server 2012 以降ではサポートされていません。

Reserved

NULLする必要があります。

戻り値

この関数は、成功した場合に空のデバイス情報セットにハンドルを返します。それ以外の場合は、INVALID_HANDLE_VALUEを返します。拡張エラー情報を取得するには、GetLastError呼び出します。

備考

この関数の呼び出し元は、SetupDiDestroyDeviceInfoList呼び出して不要になったときに、返されたデバイス情報セットを削除する必要があります。

デバイス情報セットがリモートコンピューター上のデバイス用である場合 (MachineName が NULLされていない場合)、このセットまたはその要素に対するすべての後続の操作は、リモート要素を持つデバイス情報セットをサポートするルーチンを使用する必要があります。 SetupDiXxx ルーチン (SetupDiCallClassInstallerなど) 、このサポートを提供しないルーチンには、参照ページでその効果を示すステートメントがあります。

手記

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

必要条件

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

次の方法で共有

SetupDiCreateDeviceInfoListExA 関数 (setupapi.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース