Función QualifierSet_BeginEnumeration
Restablece un enumerador de los calificadores de un objeto al principio de la enumeración.
Nota
Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.
Sintaxis
HRESULT QualifierSet_BeginEnumeration (
[in] int vFunc,
[in] IWbemQualifierSet* ptr,
[in] LONG lFlags
);
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 se corresponde con una combinación bit a bit de las marcas o valores que se describen en la sección Comentarios. Esta combinación puede usarse para especificar los calificadores que deben incluirse en la enumeración.
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 | El parámetro lFlags no es válido. |
WBEM_E_UNEXPECTED |
0x8004101d | Si se devuelve este valor, significará que se realizó una segunda llamada a la función QualifierSet_BeginEnumeration sin que se realizase una llamada de intervención a la función QualifierSet_EndEnumeration. |
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_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::BeginEnumeration.
Para enumerar todos los calificadores de un objeto, se debe llamar a este método antes de realizar la primera llamada a la función QualifierSet_Next. Se garantiza que el orden en el que se enumeran los calificadores es invariable para una enumeración determinada.
Las marcas que se pueden pasar en el argumento lEnumFlags se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlas como constantes en el código.
| Constante | Value | Descripción |
|---|---|---|
| 0 | Si se usa este valor, se devolverán los nombres de todos los calificadores. | |
WBEM_FLAG_LOCAL_ONLY |
0x10 | Si se usa este valor, solo se devolverán los nombres de los calificadores que sean específicos de la propiedad o el objeto actual. En el caso de una propiedad: solo se devuelven los calificadores que sean específicos de la propiedad (incluidas las invalidaciones) y no devuelve los calificadores que se hayan propagado desde la definición de clase. En el caso de una instancia: solo se devuelven los nombres de los calificadores que sean específicos de la instancia. En el caso de una clase: solo se devuelven los calificadores que sean específicos de la clase que se deriva. |
WBEM_FLAG_PROPAGATED_ONLY |
0x20 | Si se usa este valor, solo se devuelven los nombres de los calificadores que se propagan desde otro objeto. En el caso de una propiedad: solo se devuelven los calificadores que se hayan propagado a esta propiedad desde la definición de clase y no los de la propia propiedad. En el caso de una instancia: solo se devuelven los calificadores que se hayan propagado desde la definición de clase. En el caso de una clase: solo se devuelven los nombres de calificador que se hayan heredado de las clases primarias. |
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: WMINet_Utils.idl
Versiones de .NET Framework: está disponible desde la versión 4.7.2
