Función RpcAsyncAbortCall (rpcasync.h)

Artículo
08/25/2023

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