Compartir a través de


Función RpcServerTestCancel (rpcdce.h)

El servidor llama a RpcServerTestCancel para probar las solicitudes de cancelación del cliente.

Sintaxis

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

Parámetros

BindingHandle

Llame a para probar los comandos cancel. Si se especifica un valor de cero, el servidor suplanta al cliente que atiende este subproceso de servidor.

Valor devuelto

Valor Significado
RPC_S_OK
El cliente canceló la llamada. El servidor todavía debe completar o anular la llamada.
RPC_S_NO_CALL_ACTIVE
No hay ninguna llamada activa en el subproceso actual.
RPC_S_CALL_IN_PROGRESS
No se canceló la llamada.
RPC_S_INVALID_BINDING
El identificador no es válido.
 
Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

Comentarios

El servidor llama a RpcServerTestCancel para averiguar si el cliente ha solicitado la cancelación de una llamada pendiente. La función RpcServerTestCancel solo indica si un cliente ha cancelado la llamada; el estado no se cambia en el servidor o el cliente. El servidor RPC debe completar o anular la llamada cancelada, mediante llamadas a la función RpcAsyncCompleteCall o RpcAsyncAbortCall , respectivamente.

El parámetro BindingHandle especifica la llamada en la que se va a probar. Si el parámetro tiene un valor de cero, se prueba la llamada en el subproceso actual. El servidor puede llamar a la función RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) para probar un mensaje de cancelación mediante el identificador asincrónico para obtener el identificador de enlace.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rpcdce.h (incluir Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RPC asincrónico

RPC_ASYNC_STATE

RpcAsyncAbortCall

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcAsyncInitializeHandle