IWbemClassObject::GetObjectText メソッド (wbemcli.h)

IWbemClassObject::GetObjectText メソッドは、MOF 構文でオブジェクトのテキスト レンダリングを返します。 返される MOF テキストには、オブジェクトに関するすべての情報が含まれているのではなく、MOF コンパイラが元のオブジェクトを再作成するのに十分な情報のみが含まれていることに注意してください。 たとえば、伝達された修飾子や親クラスのプロパティは表示されません。

構文

HRESULT GetObjectText(
  [in]  long lFlags,
  [out] BSTR *pstrObjectText
);

パラメーター

[in] lFlags

通常は 0 です。 WBEM_FLAG_NO_FLAVORSが指定されている場合、修飾子は伝達またはフレーバー情報なしで表示されます。

[out] pstrObjectText

これは、エントリで NULL を指す必要があります。 このパラメーターは、SysAllocString で初期化された新しく割り当てられた BSTR を Windows Management から受け取ります。 文字列が不要になった場合は、ポインターで SysFreeString を呼び出す必要があります。 このポインターは、呼び出しから返されたオブジェクトの MOF 構文レンダリングを指します。 これは out パラメーターであるため、ポインターは割り当て解除されないため、このメソッドが呼び出される前に有効な文字列を指す必要はありません。

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

解説

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

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

要件

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

関連項目

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE