Compartilhar via


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

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:

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)

Confira também

IWbemCallResult

IWbemServices::D eleteClass

IWbemServices::DeleteInstance

IWbemServices::ExecMethod

IWbemServices::GetObject

IWbemServices::OpenNamespace

IWbemServices::PutInstance