Función RpcAsyncCancelCall (rpcasync.h)

El cliente llama a la función RpcAsyncCancelCall para cancelar una llamada asincrónica.

Sintaxis

RPC_STATUS RpcAsyncCancelCall(
  PRPC_ASYNC_STATE pAsync,
  BOOL             fAbort
);

Parámetros

pAsync

Puntero a la estructura RPC_ASYNC_STATE que contiene información de llamada asincrónica.

fAbort

Si es TRUE, la llamada se cancela inmediatamente. Si es FALSE, espere a que el servidor complete la llamada.

Valor devuelto

Comentarios

Hay dos maneras de que un cliente solicite la cancelación de una llamada asincrónica: abortiva y nonabortive. En una cancelación anulativa (fAbortCall es TRUE), la función RpcAsyncCancelCall envía una notificación de cancelación al servidor y al lado cliente y la llamada asincrónica se cancela inmediatamente, sin esperar una respuesta del servidor. Tenga en cuenta que, en una aplicación multiproceso, el cliente solo puede cancelar una llamada asincrónica después de que el subproceso que originó la llamada se haya devuelto correctamente. Esto es necesario para asegurarse de que la llamada no se cancelará de forma asincrónica por otro subproceso después de que se haya producido un error sincrónicamente mientras se emite. En general, si se produce un error en una llamada asincrónica, no se debe cancelar de forma asincrónica. La aplicación cliente debe garantizar este comportamiento si se pueden emitir y cancelar llamadas en subprocesos diferentes.

El servidor comprueba si hay solicitudes de cancelación del cliente mediante una llamada a RpcServerTestCancel. Según el estado de la llamada en el momento en que se emitió la solicitud de cancelación y la frecuencia con la que el servidor comprueba las cancelaciones, la llamada puede o no completarse normalmente. La aplicación cliente debe llamar a RpcAsyncCompleteCall para completar la llamada y el valor devuelto indicará si la llamada se completó, produjo un error o se canceló. Sin embargo, el cliente debe esperar a que se complete la llamada original antes de llamar a RpcAsyncCompleteCall.

En una cancelación nonabortiva (fAbortCall es FALSE), la función RpcAsyncCancelCall notifica al servidor de la cancelación y el cliente espera a que el servidor complete la llamada. No hay ningún mecanismo de tiempo de espera integrado. Si desea que se agote el tiempo de espera de la llamada, el cliente debe emitir primero una cancelación nobortiva mediante su propio mecanismo de tiempo de espera. Si se agota el tiempo de espera de la llamada, el cliente puede emitir una cancelación anulativa.

Requisitos

Consulte también

RPC asincrónico

RPC_ASYNC_STATE

RpcAsyncAbortCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcAsyncInitializeHandle

RpcServerTestCancel