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

Artículo
08/27/2023

El método IWbemCallResult::GetCallStatus devuelve al usuario el estado de la llamada semisynchronous pendiente actual. Cuando esta llamada devuelve WBEM_S_NO_ERROR, se completa la llamada original al método IWbemServices .

Sintaxis

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

Parámetros

[in] lTimeout

Especifica el tiempo máximo en milisegundos que esta llamada bloquea antes de que se devuelva. Si usa la constante WBEM_INFINITE (0xFFFFFFFF), la llamada se bloquea hasta que se complete la llamada semisynchronous original a un método IWbemServices . Si usa 0 (cero), la llamada devuelve inmediatamente el estado de la llamada.

[out] plStatus

Si WBEM_S_NO_ERROR devuelve en el HRESULT a este método, este parámetro recibirá el estado de resultado final de una llamada a uno de los métodos IWbemServices : OpenNamespace, PutInstance, PutClass, GetObject, DeleteInstance, DeleteClass o ExecMethod. En caso de error, no se usará el valor al que apunta plStatus .

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.

Comentarios

En caso de error, puede llamar a la función COM GetErrorInfo para obtener más información de error. También se pueden devolver códigos de error específicos de COM si los problemas de red hacen que pierda la conexión remota a administración de Windows.

Después de invocar un método IWbemServices de forma semiincrónica, puede llamar a GetCallStatus en cualquier momento para determinar si la llamada se ha completado. Después de que GetCallStatus haya devuelto WBEM_S_NO_ERROR, que indica la finalización de la operación IWbemServices original, es posible que se necesiten llamadas a otros métodos IWbemCallResult para recuperar el resultado de la llamada, según las reglas siguientes:

Para IWbemServices::OpenNamespace, se debe llamar al método GetResultServices para recuperar el nuevo puntero IWbemServices .
Para IWbemServices::P utInstance, se debe llamar al método GetResultString para obtener la ruta de acceso del objeto que se asignó al objeto.
Para IWbemServices::GetObject, se debe llamar al método GetResultObject para recuperar el objeto.
Para los métodos IWbemServices DeleteInstance, DeleteClass y ExecMethod, el método GetCallStatus es la única llamada que devuelve información sobre estas operaciones.

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)