<Return[S]><Top>

SetupDiCreateDeviceInfoListEx

Declare Sub Api_SetupDiCreateDeviceInfoListEx Lib "setupapi" Alias "SetupDiCreateDeviceInfoListExA" (ByRef ClassGuid As GUID, ByVal hwndParent&, ByVal MachineName$, Reserved As Any)

Declare Sub SetupDiCreateDeviceInfoListEx Lib "setupapi" Alias "SetupDiCreateDeviceInfoListExA" (ByRef ClassGuid As GUID, ByVal hwndParent As Long, ByVal MachineName As String, Reserved As Any)

ローカルまたはリモートコンピュータに関する空のデバイス情報セットを作成する。このセットにはクラス GUID を関連付けることができる。

パラメータ
ClassGuid
    このデバイス情報セットに関連付けるセットアップクラスの GUID を指定する。このパラメータはオプションである。このパラメータを指定する

    と、このクラスに所属するデバイスだけをこのデバイス情報セットに含めることができる。
hwndParent
    特定のデバイスに固有のものではないアクションに関連するユーザーインターフェイスを表示する、トップレベルウィンドウのハンドルを指定す

    る。このパラメータはオプションである。
MachineName
    ネットワーク内のコンピュータの名前を指定する。このパラメータはオプションである。このパラメータを指定した場合、このデバイス情報セット

    に追加したデバイスは、指定したコンピュータ上に存在していなければならない。MachineName が NULL の場合、デバイス情報セットは

    ローカルデバイスに適用される。
Reserved
    予約されている。NULL でなければならない。

戻り値
    関数が成功すると、空のデバイス情報セットのハンドルが返る。
    関数が失敗すると、INVALID_HANDLE_VALUE が返る。拡張エラー情報を取得するには、 関数を使う。

解説
    使い終わったデバイス情報セットを破棄するには、SetupDiDestroyDeviceInfoList 関数を使う。