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

Artigo
08/27/2023

O método IWbemClassObject::GetNames recupera os nomes das propriedades no objeto . Além disso, dependendo dos critérios de seleção fornecidos pelo usuário, ele pode recuperar todas ou um subconjunto das propriedades. Essas propriedades podem ser acessadas usando IWbemClassObject::Get para cada nome. Esse método também pode retornar propriedades do sistema.

Sintaxe

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

Parâmetros

[in] wszQualifierName

Um parâmetro que pode ser NULL. Se não for NULL, ele deverá apontar para um LPCWSTR válido especificando um nome de qualificador que opera como parte de um filtro. Isso é tratado como somente leitura. Para obter mais informações, consulte Comentários.

[in] lFlags

Para obter mais informações, consulte Comentários.

[in] pQualifierVal

Um parâmetro que pode ser NULL. Se não for NULL, ele deverá apontar para uma estrutura VARIANT válida inicializada para um valor de filtro. Essa VARIANT é tratada como somente leitura pelo método . Portanto, o chamador deve chamar VariantClear nele, se necessário. Para obter mais informações, consulte Comentários.

[out] pNames

Um parâmetro que não pode ser NULL, mas na entrada esse parâmetro deve apontar para NULL. Uma nova estrutura SAFEARRAY é sempre alocada e o ponteiro é definido para apontar para ela. A matriz retornada pode ter 0 elementos, mas é sempre alocada quando WBEM_S_NO_ERROR retorna. Em caso de erro, uma nova estrutura SAFEARRAY não é retornada.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Comentários

Os nomes retornados são controlados por uma combinação de sinalizadores e parâmetros. Por exemplo, todos os nomes de todas as propriedades podem ser especificados ou apenas as propriedades de chave podem ser especificadas e assim por diante. O filtro primário é especificado no parâmetro lFlags ; os outros parâmetros variam dependendo dele.

Os valores de sinalizador são campos de bits e podem ser combinados. Um sinalizador de cada um dos grupos a seguir pode ser combinado com um sinalizador de cada um dos outros grupos. Os valores de sinalizador dentro de um grupo são mutuamente exclusivos.

Sinalizadores do grupo 1	Descrição
WBEM_FLAG_ALWAYS	Retornar todos os nomes de propriedade. Os parâmetros strQualifierName e pQualifierVal não são usados.
WBEM_FLAG_ONLY_IF_TRUE	Retornar somente propriedades que tenham um qualificador do nome especificado pelo parâmetro strQualifierName. Se esse sinalizador for usado, você deverá especificar strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE	Retornar somente propriedades que não têm um qualificador do nome especificado pelo parâmetro strQualifierName. Se esse sinalizador for usado, você deverá especificar strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL	Retornar somente propriedades que tenham um qualificador do nome especificado pelo parâmetro QualifierName e também tenham um valor idêntico ao valor especificado pela estrutura VARIANT apontada por pQualifierVal. Se esse sinalizador for usado, você deverá especificar QualifierName e pQualifierVal.

Sinalizadores do grupo 2	Descrição
WBEM_FLAG_KEYS_ONLY	Retornar somente os nomes da propriedade ou das propriedades que definem as chaves.
WBEM_FLAG_REFS_ONLY	Retornam apenas nomes de propriedade que são referências de objeto.

Sinalizadores do grupo 3	Descrição
WBEM_FLAG_LOCAL_ONLY	Retornar somente nomes de propriedade que pertencem à classe mais derivada. Exclua as propriedades da classe pai ou das classes pai.
WBEM_FLAG_PROPAGATED_ONLY	Retornar somente nomes de propriedade que pertencem à classe pai ou às classes pai.
WBEM_FLAG_SYSTEM_ONLY	Retornar somente propriedades do sistema.
WBEM_FLAG_NONSYSTEM_ONLY	Retornar somente nomes de propriedade que não são propriedades do sistema.

Não é um erro que uma lista vazia seja retornada nos casos em que nenhuma propriedade corresponda aos filtros especificados.

Para obter mais informações sobre como usar estruturas SAFEARRAY de valores BSTR , consulte Recuperando parte de uma instância WMI.

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (include Wbemidl.h)
Biblioteca	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll