Método IWbemCallResult::GetCallStatus (wbemcli.h)
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 IWbemServicesDeleteInstance, 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) |