Método IWbemCallResult::GetCallStatus (wbemcli.h)

Artigo
08/27/2023

O método IWbemCallResult::GetCallStatus retorna ao usuário o status da chamada semissíncrona pendente atual. Quando essa chamada retorna WBEM_S_NO_ERROR, a chamada original para o método IWbemServices é concluída.

Sintaxe

HRESULT GetCallStatus(
  [in]  long lTimeout,
  [out] long *plStatus
);

Parâmetros

[in] lTimeout

Especifica o tempo máximo em milissegundos que essa chamada bloqueia antes de retornar. Se você usar a WBEM_INFINITE constante (0xFFFFFFFF), a chamada será bloqueada até que a chamada semissíncrona original para um método IWbemServices seja concluída. Se você usar 0 (zero), a chamada retornará imediatamente a chamada status.

[out] plStatus

Se WBEM_S_NO_ERROR retornar no HRESULT para esse método, esse parâmetro receberá o resultado final status de uma chamada para um dos métodos IWbemServices: OpenNamespace, PutInstance, PutClass, GetObject, DeleteInstance, DeleteClass ou ExecMethod. Em caso de erro, o valor apontado por plStatus não será usado.

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

Em caso de erro, você pode chamar a função COM GetErrorInfo para obter mais informações de erro. Códigos de erro específicos do COM também poderão ser retornados se problemas de rede fizerem com que você perca a conexão remota com o Gerenciamento do Windows.

Depois de invocar um método IWbemServices de forma semissíncrona, você pode chamar GetCallStatus a qualquer momento para determinar se a chamada foi concluída. Depois que GetCallStatus retornar WBEM_S_NO_ERROR, que indica a conclusão da operação IWbemServices original, as chamadas para outros métodos IWbemCallResult poderão ser necessárias para recuperar o resultado da chamada, de acordo com as seguintes regras:

Para IWbemServices::OpenNamespace, o método GetResultServices deve ser chamado para recuperar o novo ponteiro IWbemServices .
Para IWbemServices::P utInstance, o método GetResultString deve ser chamado para obter o caminho do objeto atribuído ao objeto.
Para IWbemServices::GetObject, o método GetResultObject deve ser chamado para recuperar o objeto.
Para os métodos IWbemServices DeleteInstance, DeleteClass e ExecMethod, o método GetCallStatus é a única chamada que retorna informações sobre essas operações.

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)