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 |