IWbemQualifierSet::GetNames メソッド (wbemcli.h)

[アーティクル]
03/03/2024

IWbemQualifierSet::GetNames メソッドは、現在のオブジェクトまたはプロパティから使用可能なすべての修飾子の名前を取得します。または、 IFlags のフィルター値に応じて、このメソッドは特定の修飾子の名前を取得します。

名前ごとに IWbemQualifierSet::Get を使用して、これらの修飾子に名前でアクセスできます。指定されたオブジェクトの修飾子が 0 になることはエラーではありません。そのため、戻り値の pstrNames 内の文字列の数は、 WBEM_S_NO_ERROR が返されても 0 にすることができます。

構文

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

パラメーター

[in] lFlags

次のいずれかの定数。

0 (ゼロ)

すべての修飾子の名前を返します。

WBEM_FLAG_LOCAL_ONLY

現在のプロパティまたはオブジェクトに固有の修飾子の名前のみを返します。現在の修飾子セットがプロパティを参照している場合は、プロパティに固有の修飾子 (オーバーライドを含む) のみを返し、クラス定義から伝達される修飾子は返しません。現在の修飾子セットがインスタンスを参照している場合は、インスタンス固有の修飾子名のみを返します。現在の修飾子セットがクラスを参照している場合は、派生するクラスに固有の修飾子のみを返します。

WBEM_FLAG_PROPAGATED_ONLY

別のオブジェクトから反映された修飾子の名前だけを返します。たとえば、現在の修飾子セットがプロパティを参照している場合は、クラス定義からこのプロパティに伝達された修飾子のみを返し、プロパティ自体の修飾子は返しません。現在の修飾子セットがインスタンスを参照している場合は、クラス定義から伝達された修飾子のみを返します。現在の修飾子セットがクラスを参照している場合は、親クラスから継承された修飾子名のみを返します。

[out] pNames

要求された名前を含む新しい SAFEARRAY が作成されます。

エラーが返されない場合はすべて、新しい配列が作成され、それを指すように pstrNames が設定されます。これは、結果の配列に 0 個の要素がある場合でも発生します。エラーが発生した場合、新しい SAFEARRAY は返されません。

戻り値

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

注釈

BSTRの SAFEARRAYを使用する例については、「WMI インスタンスの一部を取得する」を参照してください。

要件

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

こちらもご覧ください

IWbemQualifierSet

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::Get

Share via