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

El método IWbemQualifierSet::Next recupera el siguiente calificador en una enumeración que comenzó con IWbemQualifierSet::BeginEnumeration. Se llama a este método repetidamente para enumerar todos los calificadores hasta que WBEM_S_NO_MORE_DATA devuelve. Para finalizar la enumeración temprano, llame a IWbemQualifierSet::EndEnumeration.

No se define el orden de los calificadores devueltos durante la enumeración.

Sintaxis

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pVal,
  [out] long    *plFlavor
);

Parámetros

[in] lFlags

Reservado. Este parámetro debe ser 0 (cero).

[out] pstrName

Este parámetro recibe el nombre del calificador. Siempre se asigna un nuevo BSTR cada vez que WBEM_S_NO_ERROR devuelve.

Si pstrName es NULL, se omite; de lo contrario, el autor de la llamada debe asegurarse de que este parámetro no apunte a un BSTR válido en la entrada o, de lo contrario, habrá una pérdida de memoria. Además, el autor de la llamada debe recordar llamar a SysFreeString en la cadena devuelta cuando ya no sea necesario.

[out] pVal

Este parámetro recibe el valor del calificador. VariantInit se llama a en variant mediante este método. El autor de la llamada debe llamar a VariantClear en este puntero cuando el valor ya no es necesario. Si se devuelve un código de error, la VARIANTE a la que apunta pVal se deja sin modificar. Este parámetro se omite si se establece en NULL.

[out] plFlavor

Si no es NULL, el valor al que apunta se establece en el tipo de calificador. Para obtener más información, vea Tipos de calificador y WBEM_FLAVOR_TYPE.

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.

Requisitos

Consulte también

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::EndEnumeration

Tipos de calificador