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 |