Get 関数

  • [アーティクル]

指定したプロパティ値が存在する場合、その値が取得されます。

Note

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

構文

HRESULT Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

パラメーター

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

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

wszName
[in] プロパティの名前。

lFlags
[in] 予約されています。 このパラメーターは、0 にする必要があります。

pVal
[out] 関数が正常に終了した場合、wszName プロパティの値が格納されています。 pval 引数には、修飾子の正しい型と値が割り当てられています。

pvtType
[out] 関数が正常に終了した場合、プロパティの型を示す CIM 型の定数が格納されています。 値は null である可能性もあります。

plFlavor
[out] 関数が正常に終了した場合、プロパティの取得元に関する情報を受け取ります。 この値には、null または WbemCli.h ヘッダー ファイルで定義されている次のいずれかの WBEM_FLAVOR_TYPE 定数が設定されます。

定数 値 説明
WBEM_FLAVOR_ORIGIN_SYSTEM 0x40 プロパティは、標準のシステム プロパティです。
WBEM_FLAVOR_ORIGIN_PROPAGATED 0x20 クラスの場合: プロパティは親クラスから継承されます。
インスタンスの場合: プロパティは親クラスから継承されましたが、インスタンスによって変更されていません。
WBEM_FLAVOR_ORIGIN_LOCAL 0 クラスの場合: プロパティは派生クラスに属します。
インスタンスの場合: プロパティは、インスタンスによって変更されています。つまり、値が指定されたか、修飾子が追加または変更されました。

戻り値

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

定数 値 説明
WBEM_E_FAILED 0x80041001 一般エラーが発生しました。
WBEM_E_INVALID_PARAMETER 0x80041008 1 つ以上のパラメーターが無効です。
WBEM_E_NOT_FOUND 0x80041002 指定されたプロパティが見つかりませんでした。
WBEM_E_OUT_OF_MEMORY 0x80041006 メモリ不足のため、操作を完了できません。
WBEM_S_NO_ERROR 0 関数呼び出しは成功しました。

解説

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

Get 関数を使用して、システム プロパティを取得することもできます。

pVal 引数には、修飾子と COM VariantInit 関数の正しい型と値が割り当てられています

必要条件

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

ヘッダー: WMINet_Utils.idl

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

関連項目