Función QualifierSet_GetNames
Esta función puede usarse para recuperar los nombres de todos los calificadores o solo de los que estén disponibles en el objeto o la propiedad actual.
Nota
Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.
Sintaxis
HRESULT QualifierSet_GetNames (
[in] int vFunc,
[in] IWbemQualifierSet* ptr,
[in] LONG lFlags,
[out] SAFEARRAY (BSTR)** pstrNames
);
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 de las marcas o valores que se muestran a continuación, que se usan para especificar los nombres que se deben incluir en la enumeración.
| Constante | Valor | 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. |
pstrNames
[out] El valor de este parámetro se corresponde con una nueva matriz SAFEARRAY donde se incluyen los nombres que se solicitan. Esta matriz puede tener 0 elementos. Si se produce un error, no se devolverá una nueva matriz SAFEARRAY.
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 | Valor | Descripción |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un parámetro no es válido. |
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::GetNames.
Una vez que haya recuperado los nombres de los calificadores, podrá acceder a cada uno de ellos a partir de su nombre mediante una llamada a la función QualifierSet_Get.
Si un objeto determinado presenta cero calificadores, no se trata de un error. Por tanto, el número de cadenas que se incluyan en la matriz pstrNames podrá ser 0, incluso si se devuelve el estado de función WBEM_S_NO_ERROR.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: WMINet_Utils.idl
Versiones de .NET Framework: está disponible desde la versión 4.7.2
