Método IWbemContext::GetNames (wbemcli.h)
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.
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 |