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

  • Artigo

O método IWbemContext::GetNames retorna uma estrutura SAFEARRAY de todos os nomes dos valores de contexto nomeados. Depois que todos os nomes forem conhecidos, GetValue poderá ser chamado em cada nome para recuperar o valor. Essa técnica é uma maneira de acessar os valores de contexto diferentes de chamar os métodos BeginEnumeration, Next e EndEnumeration .

Sintaxe

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

Parâmetros

[in] lFlags

Reservado. Esse parâmetro deve ser 0.

[out] pNames

Esse parâmetro não pode ser NULL, mas na entrada deve apontar para NULL. Se nenhum erro for retornado, na saída pstrNames receberá um ponteiro para uma nova estrutura SAFEARRAY do tipo VT_BSTR que contém todos os nomes de valor de contexto. O chamador deve chamar SafeArrayDestroy no ponteiro retornado quando a matriz não for mais necessária. Se um código de erro for retornado, o ponteiro será deixado sem modificações.

Nota Se não houver valores nomeados no objeto , a chamada terá êxito e retornará uma matriz de comprimento 0.
 

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 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 (inclua Wbemidl.h)
Biblioteca Wbemuuid.lib
DLL Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Confira também

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue