次の方法で共有

GetObjectText 関数

管理オブジェクト フォーマット (MOF) 構文でのオブジェクトのテキスト形式のレンダリングが返されます。

Note

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

構文

HRESULT GetObjectText (
   [in] int                vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pstrObjectText
);

パラメーター

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

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

lFlags
[in] 通常は 0 です。 WBEM_FLAG_NO_FLAVORS (または 0x1) が指定されている場合、修飾子は伝達または種類の情報なしで含まれます。

pstrObjectText [out] エントリの null へのポインター 。 戻り時は、オブジェクトの MOF 構文レンダリングを含む新しく割り当てられた BSTR です。

戻り値

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

定数 値 説明
WBEM_E_FAILED 0x80041001 一般エラーが発生しました。
WBEM_E_INVALID_PARAMETER 0x80041008 パラメーターが無効です。
WBEM_E_OUT_OF_MEMORY 0x80041006 メモリ不足のため、操作を完了できません。
WBEM_S_NO_ERROR 0 関数呼び出しは成功しました。

解説

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

返される MOF テキストには、オブジェクトに関するすべての情報ではなく、MOF コンパイラが元のオブジェクトを再作成するのに十分な情報だけが含まれています。 たとえば、伝達された修飾子や親クラスのプロパティは含まれません。

次のアルゴリズムは、メソッドのパラメーターのテキストを再構築するために使用されます。

  1. パラメーターは、識別子の値の順序で並べ替えられます。
  2. [in] および [out] として指定されたパラメーターは、1 つのパラメーターに結合されます。

pstrObjectText は、関数が呼び出されたときの null へのポインターである必要があります。ポインターの割り当ては解除されないため、メソッド呼び出しの前に有効な文字列を指していてはなりません。

必要条件

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

ヘッダー: WMINet_Utils.idl

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

関連項目

  • Last updated on