Compartir a través de


Función RpcAsyncAbortCall (rpcasync.h)

El servidor llama a RpcAsyncAbortCall para anular una llamada asincrónica.

Sintaxis

RPC_STATUS RpcAsyncAbortCall(
  PRPC_ASYNC_STATE pAsync,
  unsigned long    ExceptionCode
);

Parámetros

pAsync

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

ExceptionCode

Código de excepción específico de la aplicación distinto de cero. Puede ser un código de error definido por la aplicación o un código de error RPC estándar. Para obtener más información, vea Valores devueltos de RPC.

Valor devuelto

Valor Significado
RPC_S_OK
Cancelación correcta de la llamada.
RPC_S_INVALID_ASYNC_HANDLE
El identificador asincrónico no es válido.
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

El servidor llama a RpcAsyncAbortCall cuando las circunstancias requieren que anule una llamada asincrónica antes de la finalización. Por ejemplo, es posible que el autor de la llamada no tenga los permisos necesarios para realizar la solicitud o que el servidor esté demasiado ocupado para procesar la llamada. Use el parámetro ExceptionCode para especificar el motivo de la anulación. El entorno en tiempo de ejecución propaga el código de excepción al cliente como un error.

Cuando se anula una llamada asincrónica con RpcAsyncAbortCall, no se realiza ninguna serialización de los argumentos de salida y RPC libera todos los argumentos de entrada. Cuando se llama a RpcAsyncAbortCall , no es necesaria una llamada a la función RpcAsyncCompleteCall . Se debe llamar a la función RpcAsyncAbortCall solo una vez para cualquier llamada asincrónica; Una segunda llamada puede bloquear el proceso o producir errores de otras maneras inesperadas.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado rpcasync.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RPC asincrónico

RPC_ASYNC_STATE

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcAsyncInitializeHandle

RpcServerTestCancel