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

Consulte también

IWbemQualifierSet

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::Get