SetupDiGetClassPropertyW 関数 (setupapi.h)

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

SetupDiGetClassProperty 関数は、デバイスセットアップクラスまたはデバイスインターフェイスクラスに設定されているデバイスプロパティを取得します。

構文

WINSETUPAPI BOOL SetupDiGetClassPropertyW(
  [in]            const GUID       *ClassGuid,
  [in]            const DEVPROPKEY *PropertyKey,
  [out]           DEVPROPTYPE      *PropertyType,
  [out]           PBYTE            PropertyBuffer,
  [in]            DWORD            PropertyBufferSize,
  [out, optional] PDWORD           RequiredSize,
  [in]            DWORD            Flags
);

パラメーター

[in] ClassGuid

デバイスセットアップクラスまたはデバイスクラスに設定されているデバイスプロパティを取得するデバイスインターフェイスクラスを識別する GUID へのポインター。クラス型の指定については、 Flags パラメーターに関するページを参照してください。

[in] PropertyKey

要求されたデバイスクラスプロパティのデバイスプロパティキーを表す DEVPROPKEY 構造体へのポインター。

[out] PropertyType

要求されたデバイスクラスプロパティのプロパティデータ型識別子を受け取る DEVPROPTYPE 型の変数へのポインター。ここで、プロパティデータ型識別子は基本データ型識別子間のビットごとの OR であり、基本データ型が変更された場合はプロパティデータ型修飾子です。

[out] PropertyBuffer

要求されたデバイスクラスプロパティを受け取るバッファーへのポインター。 SetupDiGetClassProperty は、バッファーがすべてのプロパティ値データを保持するのに十分な大きさの場合にのみ、要求されたプロパティ値を取得します。ポインターには NULL を指定できます。ポインターが NULL に設定され、 RequiredSize が指定されている場合、 SetupDiGetClassProperty は*RequiredSize のデバイスクラスプロパティのサイズ (バイト単位) を返します。

[in] PropertyBufferSize

PropertyBuffer バッファーのサイズ (バイト単位)。 PropertyBuffer が NULL に設定されている場合は、PropertyBufferSize を 0 に設定する必要があります。

[out, optional] RequiredSize

デバイスクラスプロパティが取得された場合はデバイスクラスプロパティのサイズ (バイト単位) を受け取る DWORD 型の変数へのポインター。バッファーが十分な大きさでない場合は必要なバッファーサイズ。このポインターは NULL に設定できます。

[in] Flags

クラスがデバイスセットアップクラスかデバイスインターフェイスクラスかを指定する、次のいずれかの値。

DICLASSPROP_INSTALLER

ClassGuid は 、デバイスセットアップクラスを指定します。このフラグは、DICLASSPROP_INTERFACEでは使用できません。

DICLASSPROP_INTERFACE

ClassGuid は 、デバイスインターフェイスクラスを指定します。このフラグは、DICLASSPROP_INSTALLERでは使用できません。

戻り値

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

次の表には、この関数がログに記録する可能性がある一般的なエラーコードの一部が含まれています。

リターンコード	説明
ERROR_INVALID_FLAGS	Flags の値は 0 ではありません。
ERROR_INVALID_CLASS	ClassGuid で指定されたデバイスセットアップクラスが無効です。このエラーは、DICLASSPROP_INSTALLER フラグが指定されている場合にのみ発生します。
ERROR_INVALID_PARAMETER	指定されていないパラメーターが無効です。
ERROR_INVALID_REG_PROPERTY	PropertyKey によって提供されるプロパティキーが無効です。
ERROR_INVALID_REFERENCE_STRING	デバイスインターフェイス参照文字列が無効です。このエラーは、DICLASSPROP_INTERFACE フラグが指定されている場合に返すことができます。
ERROR_INVALID_DATA	指定されていない内部データ値が無効でした。
ERROR_INVALID_USER_BUFFER	ユーザーバッファーが無効です。 1 つの可能性は、 PropertyBuffer が NULL で、 PropertyBufferSize が 0 ではないことです。
ERROR_NO_SUCH_INTERFACE_CLASS	ClassGuid で指定されたデバイスインターフェイスクラスが存在しません。このエラーは、DICLASSPROP_INTERFACE フラグが指定されている場合にのみ発生します。
ERROR_INSUFFICIENT_BUFFER	システム呼び出しに渡された内部データバッファーが小さすぎます。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するのに十分なシステムメモリが不足していました。
ERROR_NOT_FOUND	要求されたデバイスプロパティが存在しません。
ERROR_ACCESS_DENIED	呼び出し元には管理者特権がありません。

注釈

SetupDiGetClassProperty は、統合デバイスプロパティモデルの一部です。

SetupAPI では、 SetupDiGetClassProperty の Unicode バージョンのみがサポートされます。

デバイスインターフェイスプロパティを設定するには、 SetupDiGetClassProperty の呼び出し元が Administrators グループのメンバーである必要があります。

ローカルコンピューター上のデバイスクラスに設定されているデバイスプロパティを表すデバイスプロパティキーを取得するには、 SetupDiGetClassPropertyKeys を呼び出します。

リモートコンピューターでデバイスクラスプロパティを取得するには、 SetupDiGetClassPropertyEx を呼び出します。

ローカルコンピューターでデバイスクラスプロパティを設定するには、SetupDiSetClassProperty を呼び出し、リモートコンピューターでデバイスクラスプロパティを設定するには、SetupDiSetClassPropertyEx を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows で使用できます。
対象プラットフォーム	Desktopユニバーサルの場合は、CM_Get_Class_Propertyを呼び出します
Header	setupapi.h (Setupapi.h を含む)
Library	Setupapi.lib