SetupDiClassGuidsFromNameExA 関数 (setupapi.h)

SetupDiClassGuidsFromNameEx 関数は、指定したクラス名に関連付けられている GUID を取得します。 この結果の一覧には、ローカル コンピューターまたはリモート コンピューターに現在インストールされているクラスが含まれています。

構文

WINSETUPAPI BOOL SetupDiClassGuidsFromNameExA(
  [in]           PCSTR  ClassName,
  [out]          LPGUID ClassGuidList,
  [in]           DWORD  ClassGuidListSize,
  [out]          PDWORD RequiredSize,
  [in, optional] PCSTR  MachineName,
                 PVOID  Reserved
);

パラメーター

[in] ClassName

クラス GUID を取得するクラスの名前。

[out] ClassGuidList

指定したクラス名に関連付けられた GUID の一覧を受け取る配列へのポインター。

[in] ClassGuidListSize

ClassGuidList 配列内の GUID の数。

[out] RequiredSize

クラス名に関連付けられた GUID の数を受け取る変数へのポインター。 この値が ClassGuidList バッファーのサイズより大きい場合、この数値は、すべての GUID を格納するために配列のサイズがどれだけ大きいかを示します。

[in, optional] MachineName

GUID を取得するリモート システムの名前を含む NULL で終わる文字列へのポインター。 このパラメーターは省略可能であり、NULLできます。 MachineName が NULL場合は、ローカル システム名が使用されます。

注意

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

Reserved

NULLする必要があります。

戻り値

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

備考

クラス名は一意であるとは限りません。GUID のみが一意です。 そのため、1 つのクラス名で複数の GUID を返すことができます。

手記

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

必要条件

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

関連項目

SetupDiClassGuidsFromName の

SetupDiClassNameFromGuidEx の