Método IWbemClassObject::GetNames (wbemcli.h)

El método IWbemClassObject::GetNames recupera los nombres de las propiedades del objeto . Además, dependiendo de los criterios de selección proporcionados por el usuario, puede recuperar todas o un subconjunto de las propiedades. A continuación, se puede tener acceso a estas propiedades mediante IWbemClassObject::Get para cada nombre. Este método también puede devolver propiedades del sistema.

Sintaxis

HRESULT GetNames(
  [in]  LPCWSTR   wszQualifierName,
  [in]  long      lFlags,
  [in]  VARIANT   *pQualifierVal,
  [out] SAFEARRAY **pNames
);

Parámetros

[in] wszQualifierName

Parámetro que puede ser NULL. Si no es NULL, debe apuntar a un LPCWSTR válido que especifique un nombre de calificador que funcione como parte de un filtro. Esto se controla como de solo lectura. Para obtener más información, vea la sección Comentarios.

[in] lFlags

Para obtener más información, vea la sección Comentarios.

[in] pQualifierVal

Parámetro que puede ser NULL. Si no es NULL, debe apuntar a una estructura VARIANT válida inicializada en un valor de filtro. Este VARIANT se controla como de solo lectura por el método . Por lo tanto, el autor de la llamada debe llamar a VariantClear en él, si es necesario. Para obtener más información, vea la sección Comentarios.

[out] pNames

Un parámetro que no puede ser NULL, pero en la entrada, este parámetro debe apuntar a NULL. Siempre se asigna una nueva estructura SAFEARRAY y el puntero se establece para que apunte a ella. La matriz devuelta puede tener 0 elementos, pero siempre se asigna cuando WBEM_S_NO_ERROR devuelve. En caso de error, no se devuelve una nueva estructura 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. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Comentarios

Los nombres devueltos se controlan mediante una combinación de marcas y parámetros. Por ejemplo, se pueden especificar todos los nombres de todas las propiedades, o solo se pueden especificar las propiedades de clave, etc. El filtro principal se especifica en el parámetro lFlags ; los demás parámetros varían en función de él.

Los valores de marca son campos de bits y se pueden combinar. Una marca de cada uno de los grupos siguientes se puede combinar con una marca de cada uno de los otros grupos. Los valores de marca dentro de un grupo son mutuamente excluyentes.

Marcas del grupo 1	Descripción
WBEM_FLAG_ALWAYS	Este valor se usa para obtener todos los nombres de propiedad. No se usan los parámetros strQualifierName y pQualifierVal .
WBEM_FLAG_ONLY_IF_TRUE	Devuelve solo las propiedades que tienen un calificador del nombre especificado por el parámetro strQualifierName. Si se usa esta marca, debe especificar strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE	Devuelve solo las propiedades que no tienen un calificador del nombre especificado por el parámetro strQualifierName. Si se usa esta marca, debe especificar strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL	Devuelve solo las propiedades que tienen un calificador del nombre especificado por el parámetro QualifierName y también tienen un valor idéntico al valor especificado por la estructura VARIANT a la que apunta pQualifierVal. Si se usa esta marca, debe especificar QualifierName y pQualifierVal.

 

Marcas del grupo 2	Descripción
WBEM_FLAG_KEYS_ONLY	Devuelve solo los nombres de la propiedad o las propiedades que definen las claves.
WBEM_FLAG_REFS_ONLY	Este valor se usa para obtener únicamente los nombres de propiedad que constituyan referencias de objeto.

 

Marcas del grupo 3	Descripción
WBEM_FLAG_LOCAL_ONLY	Devuelve solo los nombres de propiedad que pertenecen a la clase derivada más. Excluya las propiedades de la clase primaria o de las clases primarias.
WBEM_FLAG_PROPAGATED_ONLY	Devuelve solo los nombres de propiedad que pertenecen a la clase primaria o a las clases primarias.
WBEM_FLAG_SYSTEM_ONLY	Devuelve solo las propiedades del sistema.
WBEM_FLAG_NONSYSTEM_ONLY	Devuelve solo los nombres de propiedad que no son propiedades del sistema.

 

No es un error para que se devuelva una lista vacía en los casos en los que ninguna propiedad coincida con los filtros especificados.

Para obtener más información sobre el uso de estructuras SAFEARRAY de valores BSTR , vea Recuperar parte de una instancia de WMI.

Requisitos

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	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Consulte también

IWbemClassObject

IWbemClassObject::BeginEnumeration

IWbemClassObject::Get

WBEM_CONDITION_FLAG_TYPE

Propiedades del sistema de WMI