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
Requisito | Value |
---|---|
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 | Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll |
Consulte también
IWbemQualifierSet::BeginEnumeration