Функция GetNamesGetNames 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] This parameter is unused.

ptr
окне Указатель на экземпляр ивбемклассобжект .[in] A pointer to an IWbemClassObject instance.

wszQualifierName
окне Указатель на допустимое значение 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] A combination of bit fields. Дополнительные сведения см. в разделе Примечания.For more information, see the Remarks section.

pQualifierValue окне Указатель на допустимую 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

Следующие значения, возвращаемые этой функцией, определены в файле заголовка вбемкли. 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 ЗначениеValue ОписаниеDescription
WBEM_E_FAILED 0x800410010x80041001 Общий сбой.There has been a general failure.
WBEM_E_INVALID_PARAMETER 0x800410080x80041008 Один или несколько параметров недопустимы или указаны неверное сочетание флагов и параметров.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

Эта функция заключает в оболочку вызов метода ивбемклассобжект:: Names .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 аргумента, являются битовыми полями, определенными в файле заголовка вбемкли. 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. Можно объединить один флаг из каждой группы с любым флагом из любой другой группы.You can combine one flag from each group with any flag from any other group. Однако флаги из одной и той же группы являются взаимоисключающими.However, flags from the same group are mutually exclusive.

Флаги группы 1Group 1 flags ЗначениеValue ОписаниеDescription
WBEM_FLAG_ALWAYS 00 Возвращает все имена свойств.Return all property names. strQualifierName и pQualifierVal не используются.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.
Флаги группы 2Group 2 flags ЗначениеValue Описание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.
Флаги группы 3Group 3 flags ЗначениеValue Описание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 , и pstrNames всегда устанавливается для указания на нее.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.2Available since 4.7.2.NET Framework Versions: Доступно с версии 4.7.2Available since 4.7.2

См. также разделSee also