GetNames 関数GetNames function

オブジェクトのプロパティの名前の一部またはすべてが取得されます。Retrieves either a subset or all of the names of the properties of an object.

注意

この API は、内部でだけ使用します。This API is for internal use only. 開発者コードで使用するためのものではありません。It's not intended for use from developer code.

構文Syntax

HRESULT GetNames (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
);

パラメーターParameters

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

ptr
[in]インスタンスへのポインター。[in] A pointer to an IWbemClassObject instance.

wszQualifierName
[in]フィルターの一部としてLPCWSTR動作する修飾子名を指定する有効なポインター。[in] A pointer to a valid LPCWSTR that specifies a qualifier name that operates as part of a filter. 詳細については、「解説」を参照してください。For more information, see the Remarks section. このパラメーターは、null に設定できます。This parameter can be null.

lFlags
[in]ビット フィールドの組み合わせ。[in] A combination of bit fields. 詳細については、「解説」を参照してください。For more information, see the Remarks section.

pQualifierValue[in]フィルター値に初期化されたVARIANT有効な構造体へのポインター。pQualifierValue [in] A pointer to a valid VARIANT structure initialized to a filter value. このパラメーターは、null に設定できます。This parameter can be null.

pstrNames
[アウト]プロパティSAFEARRAY名を含む構造体。[out] A SAFEARRAY structure that contains property names. エントリ時には、このパラメーターは常にnullへのポインターである必要があります。On entry, this parameter must always be a pointer to null. 詳細については、「解説」を参照してください。See the Remarks section for more information.

戻り値Return value

この関数によって返される次の値は 、WbemCli.hヘッダー ファイルで定義されているか、コード内で定数として定義できます。The following values returned by this function are defined in the WbemCli.h header file, or you can define them as constants in your code:

常時Constant ValueValue 説明Description
WBEM_E_FAILED 0x800410010x80041001 一般的なエラーが発生しました。There has been a general failure.
WBEM_E_INVALID_PARAMETER 0x800410080x80041008 1 つ以上のパラメーターが無効であるか、またはフラグとパラメーターの正しくない組み合わせが指定されています。One or more parameters are not valid, or an incorrect combination of flags and parameters was specified.
WBEM_E_OUT_OF_MEMORY 0x800410060x80041006 メモリ不足のため、操作を完了できません。Not enough memory is available to complete the operation.
WBEM_S_NO_ERROR 00 関数呼び出しが正常に行われました。The function call was successful.

解説Remarks

この関数は、メソッドの呼び出しをラップしますThis function wraps a call to the IWbemClassObject::GetNames method.

戻される名前は、フラグとパラメーターの組み合わせによって制御されます。The named returned are controlled by a combination of flags and parameters. たとえば、この関数は、すべてのプロパティの名前を返したり、キー プロパティの名前のみを返したりできます。For example, the function can return the names of all properties or only the names of the key properties. プライマリ フィルタはlFlagsパラメータで指定され、その他のパラメータはパラメータによって異なります。The primary filter is specified in the lFlags parameter, and the other parameters vary depending on it.

のフラグ値lFlagsはビットフィールドですThe flag values in lFlags are bit fields

lEnumFlags引数として渡すことができるフラグは 、WbemCli.hヘッダー ファイルで定義されているビット フィールドか、コード内で定数として定義できます。The flags that can be passed as the lEnumFlags argument are bit fields that are defined in the WbemCli.h header file, or you can define them as constants in your code. 各グループの 1 つのフラグを、他のグループの任意のフラグと組み合わせることができます。You can combine one flag from each group with any flag from any other group. ただし、同じグループのフラグは相互に排他的です。However, flags from the same group are mutually exclusive.

グループ 1 フラグGroup 1 flags ValueValue 説明Description
WBEM_FLAG_ALWAYS 00 すべてのプロパティ名を返します。Return all property names. strQualifierNamepQualifierVal使用されていない。strQualifierName and pQualifierVal are unused.
WBEM_FLAG_ONLY_IF_TRUE 11 strQualifierNameパラメーターで指定された名前の修飾子を持つプロパティのみを返します。Return only properties that have a qualifier of the name specified by the strQualifierName parameter. このフラグを使用する場合は、strQualifierNameを指定する必要があります。If this flag is used, you must specify strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE 22 strQualifierNameパラメーターで指定された名前の修飾子を持たないプロパティのみを返します。Return only properties that do not have a qualifier of the name specified by the strQualifierName parameter. このフラグを使用する場合は、strQualifierNameを指定する必要があります。If this flag is used, you must specify strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL 33 wszQualifierNameパラメーターで指定された名前の修飾子を持ち、pQualifierVal構造体で指定された値と同じ値を持つプロパティのみを返します。Return only properties that have a qualifier of the name specified by the wszQualifierName parameter and also have a value identical to that specified by the pQualifierVal structure. このフラグを使用する場合は、 とwszQualifierNameを両方pQualifierValueとも指定する必要があります。If this flag is used, you must specify both a wszQualifierName and a pQualifierValue.
グループ 2 フラグGroup 2 flags ValueValue 説明Description
WBEM_FLAG_KEYS_ONLY 0x40x4 キーを定義するプロパティの名前のみを返します。Return only the names of properties that define the keys.
WBEM_FLAG_REFS_ONLY 0x80x8 オブジェクト参照であるプロパティ名のみを返します。Return only property names that are object references.
グループ 3 フラグGroup 3 flags ValueValue 説明Description
WBEM_FLAG_LOCAL_ONLY 0x100x10 最も派生したクラスに属するプロパティ名のみを返します。Return only property names that belong to the most derived class. 親クラスからプロパティを除外します。Exclude properties from the parent classes.
WBEM_FLAG_PROPAGATED_ONLY 0x200x20 親クラスに属するプロパティ名のみを返します。Return only property names that belong to the parent classes.
WBEM_FLAG_SYSTEM_ONLY 0x300x30 システム プロパティの名前のみを返します。Return only the names of system properties.
WBEM_FLAG_NONSYSTEM_ONLY 0x400x40 システムプロパティ以外の名前のみを返します。Return only the names of non-system properties.

関数は、 が戻SAFEARRAY``WBEM_S_NO_ERRORる場合は常にpstrNamesnew を割り当て、常にこの関数を指す値に設定されます。The function always allocates a new SAFEARRAY if it returns WBEM_S_NO_ERROR, and pstrNames is always set to point to it. 指定したフィルターに一致するプロパティがない場合、返される配列の要素は 0 になります。The returned array can have 0 elements if no properties match the specified filters. 関数がWBM_S_NO_ERROR以外の値を返す場合、SAFEARRAY新しい構造体は返されません。If the function returns an value other than WBM_S_NO_ERROR, a new SAFEARRAY structure is not returned.

必要条件Requirements

:システム要件」を参照してください。Platforms: See System Requirements.

ヘッダー: WMINet_Utils.idlHeader: WMINet_Utils.idl

.NET Framework のバージョン: 4.7.2 以降で利用可能Available since 4.7.2.NET Framework Versions: 4.7.2 以降で利用可能Available since 4.7.2

関連項目See also