Бөлісу құралы:

Функция Next

Извлекает следующее свойство в перечислении, которое начинается с вызова BeginEnumeration.

Примечание

Этот интерфейс API предназначен только для внутреннего использования. Он не предназначен для использования из кода разработчика.

Синтаксис

HRESULT Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Параметры

vFunc
[in] Этот параметр не используется.

ptr
[in] Указатель на экземпляр IWbemClassObject .

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

pstrName
[out] Новый BSTR объект , содержащий имя свойства. Для этого параметра можно задать значение , null если имя не является обязательным.

pVal
[out] Объект VARIANT , заполненный значением свойства . Для этого параметра можно задать значение , null если значение не является обязательным. Если функция возвращает код ошибки, то объект , переданный VARIANT в pVal , остается без изменений.

pvtType
[out] Указатель на переменную CIMTYPE (, LONG в которую помещается тип свойства). Значением этого свойства может быть VT_NULL_VARIANT, в этом случае необходимо определить фактический тип свойства. Этот параметр также может иметь значение null.

plFlavor
[out] null, или значение, которое получает сведения о происхождении свойства. Возможные значения см. в разделе [Примечания].

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

Следующие значения, возвращаемые этой функцией, определяются в файле заголовка WbemCli.h , или их можно определить как константы в коде:

Константа Значение Описание
WBEM_E_FAILED 0x80041001 Произошел общий сбой.
WBEM_E_INVALID_PARAMETER 0x80041008 Недопустимый параметр.
WBEM_E_UNEXPECTED 0x8004101d Не было вызова BeginEnumeration функции.
WBEM_E_OUT_OF_MEMORY 0x80041006 Недостаточно памяти для начала нового перечисления.
WBEM_E_TRANSPORT_FAILURE 0x80041015 Сбой удаленного вызова процедуры между текущим процессом и управлением Windows.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.
WBEM_S_NO_MORE_DATA 0x40005 В перечислении больше нет свойств.

Комментарии

Эта функция создает оболочку для вызова метода IWbemClassObject::Next .

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

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

Если plFlavor значение не nullравно , LONG значение получает сведения о происхождении свойства следующим образом:

Константа Значение Описание
WBEM_FLAVOR_ORIGIN_SYSTEM 0x40 Свойство является стандартным системным свойством.
WBEM_FLAVOR_ORIGIN_PROPAGATED 0x20 Для класса: свойство наследуется от родительского класса.
Для экземпляра: свойство, унаследованное от родительского класса, не было изменено экземпляром .
WBEM_FLAVOR_ORIGIN_LOCAL 0 Для класса: свойство принадлежит производного класса.
Для экземпляра: свойство изменяется экземпляром ; то есть было предоставлено значение или добавлен или изменен квалификатор.

Требования

Платформы: см. раздел Требования к системе.

Заголовка: WMINet_Utils.idl

версии платформа .NET Framework: доступно с версии 4.7.2.

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

  • Last updated on