Método IWbemQualifierSet::GetNames (wbemcli.h)
El método IWbemQualifierSet::GetNames recupera los nombres de todos los calificadores disponibles en el objeto o propiedad actual. Como alternativa, dependiendo del valor de filtro de IFlags, este método recupera los nombres de determinados calificadores.
Puede acceder a estos calificadores por nombre, mediante IWbemQualifierSet::Get para cada nombre. No es un error para que ningún objeto determinado tenga cero calificadores, por lo que el número de cadenas en pstrNames al devolver puede ser 0, aunque WBEM_S_NO_ERROR devuelva.
Sintaxis
HRESULT GetNames(
[in] long lFlags,
[out] SAFEARRAY **pNames
);
Parámetros
[in] lFlags
Una de las siguientes constantes.
0 (cero)
Si se usa este valor, se devolverán los nombres de todos los calificadores.
WBEM_FLAG_LOCAL_ONLY
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. Si el conjunto de calificadores actuales hace referencia a una propiedad, devuelve solo los calificadores específicos de la propiedad (incluidas las invalidaciones) y no esos calificadores propagados desde la definición de clase. Si el conjunto de calificadores actuales hace referencia a una instancia, devuelva solo nombres de calificador específicos de la instancia. Si el conjunto de calificadores actuales hace referencia a una clase, devuelva solo calificadores específicos de la clase que se va a derivar.
WBEM_FLAG_PROPAGATED_ONLY
Si se usa este valor, solo se devuelven los nombres de los calificadores que se propagan desde otro objeto. Por ejemplo, si el conjunto de calificadores actual hace referencia a una propiedad, devuelve solo los calificadores propagados a esta propiedad desde la definición de clase y no los de la propia propiedad. Si el conjunto de calificadores actual hace referencia a una instancia, devuelva solo los calificadores propagados desde la definición de clase. Si el conjunto de calificadores actual hace referencia a una clase, devuelva solo los nombres de calificador heredados de las clases primarias.
[out] pNames
Se crea una nueva SAFEARRAY que contiene los nombres solicitados.
En todos los casos en los que no se devuelve ningún error, se crea una nueva matriz y pstrNames se establece para que apunte a ella. Esto ocurre aunque la matriz resultante tenga cero elementos. En caso de error, no se devuelve un nuevo SAFEARRAY .
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.
Comentarios
Para obtener un ejemplo de uso de SAFEARRAYs de BSTR, vea Recuperar parte de una instancia de WMI.
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 |