Método IWbemClassObject::Next (wbemcli.h)

Artículo
08/27/2023

El método IWbemClassObject::Next recupera la siguiente propiedad en una enumeración que comenzó con IWbemClassObject::BeginEnumeration. Se debe llamar repetidamente para enumerar todas las propiedades hasta que WBEM_S_NO_MORE_DATA devuelva. Si la enumeración se va a finalizar temprano, se debe llamar a IWbemClassObject::EndEnumeration .

No se define el orden de las propiedades devueltas durante la enumeración.

Sintaxis

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

Parámetros

[in] lFlags

Reservado. El valor de este parámetro deberá ser 0.

[out] strName

Recibe un nuevo BSTR que contiene el nombre de la propiedad. Para evitar pérdidas de memoria en el proceso de cliente, el llamador debe llamar a SysFreeString cuando el nombre ya no sea necesario. Puede establecer este parámetro en NULL si el nombre no es necesario.

[out] pVal

Esta VARIANT se rellena con el valor de la propiedad . El método llama a VariantInit en este VARIANT, por lo que el autor de la llamada debe asegurarse de que VARIANT no está activo antes de la llamada. El autor de la llamada debe usar VariantClear cuando el valor ya no sea necesario.

Puede establecer este parámetro en NULL si el valor no es necesario. Si se devuelve un código de error, la VARIANTE a la que apunta pVal se deja sin modificar.

[out, optional] pType

Este parámetro puede ser NULL. Si no es NULL, debe apuntar a una variable CIMTYPE ( long) en la que se coloca el tipo de la propiedad. Es posible que el valor de esta propiedad pueda ser un VT_NULLVARIANT, en cuyo caso es necesario determinar el tipo real de la propiedad.

[out, optional] plFlavor

Puede ser NULL. Si no es NULL, el valor LONG al que apunta recibe información sobre el origen de la propiedad como se indica a continuación. Para obtener más información, vea Tipos de calificador y WBEM_FLAVOR_TYPE.

WBEM_FLAVOR_ORIGIN_SYSTEM

La propiedad es una propiedad del sistema estándar.

Para clases:

WBEM_FLAVOR_ORIGIN_PROPAGATED

La propiedad se heredó de la clase primaria.

La propiedad, mientras se hereda de la clase primaria, no se ha modificado en el nivel de instancia.

WBEM_FLAVOR_ORIGIN_LOCAL

La propiedad pertenece a la clase derivada más.

La propiedad se modifica en el nivel de instancia (es decir, se proporcionó un valor o se ha agregado o modificado un calificador).

Para instancias:

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Comentarios

Si el tipo subyacente de la propiedad es una ruta de acceso de objeto, una fecha u hora u otro tipo especial, el tipo devuelto no contiene suficiente información. El autor de la llamada debe examinar el CIMTYPE para la propiedad especificada y determinar si la propiedad es una referencia de objeto, una fecha u hora u otro tipo especial.

Este método también devuelve las propiedades del sistema.

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	WbemUuid.lib
Archivo DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll