IWbemObjectAccess::GetPropertyHandle メソッド (wbemcli.h)

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

構文

HRESULT GetPropertyHandle(
  [in]  LPCWSTR wszPropertyName,
  [out] CIMTYPE *pType,
  [out] long    *plHandle
);

[in] wszPropertyName

プロパティ名を含む 16 ビット Unicode 文字の null で終わる定数文字列。

[out] pType

プロパティの CIM 型を返すために使用される CIMTYPE へのポインター。

[out] plHandle

プロパティハンドルを返すために使用される整数へのポインター。

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。次の一覧は、 HRESULT に含まれる値の一覧です。

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

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	wbemcli.h (Wbemidl.h を含む)
Library	Wbemuuid.lib
[DLL]	Esscli.dll;Fastprox.dll;Wbemess.dll