Función QualifierSet_Next
Recupera el siguiente calificador en una enumeración que se inició con una llamada a la función QualifierSet_BeginEnumeration.
Nota
Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.
Sintaxis
HRESULT QualifierSet_Next (
[in] int vFunc,
[in] IWbemQualifierSet* ptr,
[in] LONG lFlags,
[out] BSTR* pstrName,
[out] VARIANT* pVal,
[out] LONG* plFlavor
);
Parámetros
vFunc
[in] Este parámetro no se usa.
ptr
[in] El valor de este parámetro se corresponde con un puntero que apunta a una instancia de la interfaz IWbemQualifierSet.
lFlags
[in] El valor de este parámetro está reservado. El valor de este parámetro deberá ser 0.
pstrName
[out] El valor de este parámetro se corresponde con el nombre del calificador. Si su valor es null
, este parámetro se omitirá; de lo contrario, el parámetro pstrName
no deberá apuntar a una cadena BSTR
válida, ya que esto haría que ocurriese una fuga de memoria. Si el valor no es null, siempre se asignará una nueva cadena BSTR
cuando se devuelva el valor WBEM_S_NO_ERROR
de la función.
pVal
[out] Si la función se ejecuta correctamente, el valor de este parámetro se corresponderá con el valor del calificador. Si se produce un error en la función, no se modificará el valor VARIANT
al que apunta el parámetro pVal
. Este parámetro se ignorará si su valor se establece en null
.
plFlavor
[out] El valor de este parámetro se corresponde con un puntero que apunta a un elemento LONG donde se recibirá el tipo de calificador. Si no se desea obtener la información de tipo, el valor de este parámetro podrá ser null
.
Valor devuelto
Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:
Constante | Value | Descripción |
---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un parámetro no es válido. |
WBEM_E_UNEXPECTED |
0x8004101d | Si se devuelve este valor, significará que la función QualifierSet_BeginEnumeration no recibió una llamada desde el llamador. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Si se devuelve este valor, significará que no hay suficiente memoria disponible para comenzar una nueva enumeración. |
WBEM_S_NO_MORE_DATA |
0x40005 | Si se devuelve este valor, significará que ya no quedan calificadores en la enumeración. |
WBEM_S_NO_ERROR |
0 | Si se devuelve este valor, significará que la llamada a la función se realizó correctamente. |
Comentarios
Al usar esta función, se ajusta una llamada al método IWbemQualifierSet::Next.
Llame a la función QualifierSet_Next
repetidamente para enumerar todos los calificadores hasta que se devuelva el valor WBEM_S_NO_MORE_DATA
desde la función. Para finalizar el proceso de enumeración antes de tiempo, llame a la función QualifierSet_EndEnumeration.
El orden de los calificadores que se devuelven durante el proceso de enumeración no está definido.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: WMINet_Utils.idl
Versiones de .NET Framework: está disponible desde la versión 4.7.2