Función RpcServerTestCancel (rpcdce.h)

Artículo
03/05/2024

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