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

Метод 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 для указанного свойства и определить, является ли свойство ссылкой на объект, датой или временем или другим специальным типом.

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

Требования

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

IWbemClassObject

IWbemClassObject::BeginEnumeration

IWbemClassObject::EndEnumeration

IWbemClassObject::Get

Свойства системы WMI