Метод IWbemClassObject::Next (wbemcli.h)

Статья
08/27/2023

Метод IWbemClassObject::Next извлекает следующее свойство в перечислении, которое началось с IWbemClassObject::BeginEnumeration. Этот метод следует вызывать повторно для перечисления всех свойств до тех пор, пока не будет возвращен WBEM_S_NO_MORE_DATA . Если перечисление должно быть завершено раньше, следует вызвать IWbemClassObject::EndEnumeration .

Порядок свойств, возвращаемых во время перечисления, не определен.

Синтаксис

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

Параметры

[in] lFlags

Зарезервировано. Этот параметр должен иметь значение 0.

[out] strName

Получает новый объект BSTR , содержащий имя свойства. Чтобы предотвратить утечку памяти в клиентском процессе, вызывающий объект должен вызывать SysFreeString , когда имя больше не требуется. Если имя не является обязательным, для этого параметра можно задать значение NULL .

[out] pVal

Этот вариант VARIANT заполняется значением свойства . Метод вызывает VariantInit для этого variant, поэтому вызывающий объект должен убедиться, что variant не активен перед вызовом. Вызывающий объект должен использовать VariantClear , если значение больше не требуется.

Если значение не является обязательным, для этого параметра можно задать значение NULL . Если возвращается код ошибки, значение VARIANT , на который указывает pVal , остается без изменений.

[out, optional] pType

Этот параметр может принимать значение NULL. Если значение не равно NULL, оно должно указывать на переменную CIMTYPE ( LONG), в которую помещается тип свойства . Возможно, значение этого свойства может быть VT_NULLVARIANT, в этом случае необходимо определить фактический тип свойства.

[out, optional] plFlavor

Может иметь значение NULL. Если значение НЕ РАВНО NULL, значение LONG , на которое указывает, получает сведения о происхождении свойства следующим образом. Дополнительные сведения см. в разделе Варианты квалификатора и WBEM_FLAVOR_TYPE.

WBEM_FLAVOR_ORIGIN_SYSTEM

Свойство является стандартным системным свойством.

Для классов:

WBEM_FLAVOR_ORIGIN_PROPAGATED

Свойство было унаследовано от родительского класса.

Свойство, унаследованное от родительского класса, не было изменено на уровне экземпляра.

WBEM_FLAVOR_ORIGIN_LOCAL

Свойство принадлежит к производной самой производной классу.

Свойство изменяется на уровне экземпляра (то есть было предоставлено значение или добавлен квалификатор).

Для экземпляров:

Возвращаемое значение

Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT. Общие значения HRESULT см. в разделе Системные коды ошибок.

Если базовым типом свойства является путь к объекту, дата или время или другой специальный тип, возвращаемый тип не содержит достаточно сведений. Вызывающий объект должен проверить CIMTYPE для указанного свойства и определить, является ли свойство ссылкой на объект, датой или временем или другим специальным типом.

Этот метод также возвращает системные свойства.

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll