次の方法で共有

GetPropertyHandle 関数

プロパティを識別する一意のハンドルが返されます。

Note

この API は、内部でだけ使用します。 開発者コードで使用するためのものではありません。

構文

HRESULT GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

パラメーター

vFunc
[in] このパラメーターは使用されません。

ptr
[in] IWbemObjectAccess インスタンスへのポインター。

wszPropertyName
[in] プロパティ名が格納されている、UTF16 でエンコードされた文字の null で終わる文字列。

pType
[out] プロパティの CIM 型を表す CIMTYPE 列挙型メンバーへのポインター。

pHandle
[out] プロパティ ハンドルが格納されている整数へのポインター。

戻り値

この関数によって返される次の値は、WbemCli.h ヘッダー ファイル内で定義されています。または、コード内で定数として定義することもできます。

定数 [値] 説明
WBEM_E_NOT_FOUND 0x80041002 指定したプロパティ名が見つかりませんでした。
WBEM_E_INVALID_PARAMETER 0x80041008 パラメーターが無効です。
WBEM_E_NOT_SUPPORTED 0x8004100c 要求されたプロパティの型は CIM_OBJECT または CIM_ARRAY です。
WBEM_S_NO_ERROR 0 関数呼び出しは成功しました。

解説

この関数では、IWbemClassObject::GetPropertyHandle メソッドの呼び出しがラップされます。

IWbemObjectAccess メソッドを使用してプロパティ値の読み取りまたは書き込みを行うときに、このハンドルを使用してプロパティを識別できます。

CIM_OBJECT および CIM_ARRAY 以外のすべてのデータ型のプロパティのハンドルを取得できます。 返されるハンドルは、クラスのすべてのインスタンスで機能します。

必要条件

:「システム要件」を参照してください。

ヘッダー: WMINet_Utils.idl

.NET Framework のバージョン: 4.7.2 以降で使用可能

関連項目

  • Last updated on