Функция GetNamesGetNames function

• 11/06/2017
• Чтение занимает 2 мин
• • g
  • o

Получает подмножество имен или все имена свойств объекта.Retrieves either a subset or all of the names of the properties of an object.

Синтаксис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:

Комментарии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.

Функция всегда выделяет новую 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

• WMI и счетчики производительности (справочник по неуправляемым API)WMI and Performance Counters (Unmanaged API Reference)