CM_Get_Class_Property_Keys_Ex関数 (cfgmgr32.h)
[Windows 8とWindows Server 2012以降、この関数は非推奨になりました。 代わりに CM_Get_Class_Property_Keys を使用してください。]
CM_Get_Class_Property_Keys_Ex関数は、デバイス インターフェイス クラスまたはデバイス セットアップ クラスに設定されているデバイス プロパティを表すデバイス プロパティ キーの配列を取得します。
構文
CMAPI CONFIGRET CM_Get_Class_Property_Keys_Ex(
[in] LPCGUID ClassGUID,
[out, optional] DEVPROPKEY *PropertyKeyArray,
[in, out] PULONG PropertyKeyCount,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
パラメーター
[in] ClassGUID
プロパティ キーを取得する デバイス インターフェイス クラス または デバイス セットアップ クラス を識別する GUID へのポインター。 クラス型の指定については、 ulFlags パラメーターを参照してください。
[out, optional] PropertyKeyArray
DEVPROPKEY 型の値の配列を受け取るバッファーへのポインター。各値は、デバイス クラスに設定されたデバイス プロパティを表すデバイス プロパティ キーです。 ポインターは省略可能であり、NULL にすることができます。
[in, out] PropertyKeyCount
PropertyKeyArray バッファーのサイズ (DEVPROPKEY 型の単位)。 PropertyKeyArray が NULL に設定されている場合は、*PropertyKeyCount を 0 に設定する必要があります。 出力として、 PropertyKeyArray がすべてのプロパティ キー データを保持するのに十分な大きさでない場合、 CM_Get_Class_Property_Keys_Ex は *PropertyKeyCount でキーの数を返します。
[in] ulFlags
クラス プロパティ のキー フラグ:
CM_CLASS_PROPERTY_INSTALLER
ClassGUID は 、デバイス セットアップ クラスを指定します。 CM_CLASS_PROPERTY_INTERFACEと組み合わせないでください。
CM_CLASS_PROPERTY_INTERFACE
ClassGUID は 、デバイス インターフェイス クラスを指定します。 CM_CLASS_PROPERTY_INSTALLERと組み合わせないでください。
[in, optional] hMachine
呼び出し元が指定したマシン ハンドル。 CM_Connect_Machineの前の呼び出しから取得されます。
戻り値
操作が成功した場合、関数はCR_SUCCESSを返します。 それ以外の場合は、 Cfgmgr32.h で定義されているCR_プレフィックス付きのエラー コードのいずれかを返します。
注釈
CM_Get_Class_Property_Keys_Ex は、 統合デバイス プロパティ モデルの一部です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows 10 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | cfgmgr32.h (Cfgmgr32.h を含む) |
| Library | Cfgmgr32.lib;Windows 10の OneCoreUAP.lib |
| [DLL] | CfgMgr32.dll |