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

O método IWbemQualifierSet::GetNames recupera os nomes de todos os qualificadores disponíveis do objeto ou propriedade atual. Como alternativa, dependendo do valor de filtro de IFlags, esse método recupera os nomes de determinados qualificadores.

Você pode acessar esses qualificadores por nome, usando IWbemQualifierSet::Get para cada nome. Não é um erro que um determinado objeto tenha nenhum qualificador, portanto, o número de cadeias de caracteres em pstrNames no retorno pode ser 0, mesmo que WBEM_S_NO_ERROR retorne.

Sintaxe

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Parâmetros

[in] lFlags

Uma das seguintes constantes.

0 (Zero)

Retorne os nomes de todos os qualificadores.

WBEM_FLAG_LOCAL_ONLY

Retorne apenas os nomes de qualificadoras específicos à propriedade ou objeto atual. Se o conjunto de qualificadores atual se referir a uma propriedade, retorne apenas os qualificadores específicos para a propriedade (incluindo substituições) e não os qualificadores propagados da definição de classe. Se o conjunto de qualificadores atual se referir a uma instância, retorne apenas nomes de qualificador específicos da instância. Se o conjunto de qualificadores atual se referir a uma classe, retorne apenas qualificadores específicos para a classe que está sendo derivada.

WBEM_FLAG_PROPAGATED_ONLY

Retorne apenas os nomes dos qualificadores propagados de outro objeto. Por exemplo, se o conjunto de qualificadores atual se referir a uma propriedade, retorne apenas os qualificadores propagados para essa propriedade da definição de classe e não os da própria propriedade. Se o conjunto de qualificadores atual se referir a uma instância, retorne apenas os qualificadores propagados da definição de classe. Se o conjunto de qualificadores atual se referir a uma classe, retorne apenas os nomes de qualificador herdados das classes pai.

[out] pNames

Um novo SAFEARRAY é criado que contém os nomes solicitados.

Em todos os casos em que nenhum erro é retornado, uma nova matriz é criada e pstrNames é definido para apontar para ela. Isso ocorre mesmo que a matriz resultante não tenha elementos. Em caso de erro, uma nova 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.

Comentários

Para obter um exemplo de como usar SAFEARRAYs de BSTRs, consulte Recuperando parte de uma instância WMI.

Requisitos

Requisito	Valor
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	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Confira também

IWbemQualifierSet

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::Get