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 |
|---|---|
|
El cliente canceló la llamada. El servidor todavía debe completar o anular la llamada. |
|
No hay ninguna llamada activa en el subproceso actual. |
|
No se canceló la llamada. |
|
El identificador no es válido. |
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 |