Função RpcServerTestCancel (rpcdce.h)

Artigo
03/01/2024

O servidor chama RpcServerTestCancel para testar solicitações de cancelamento de cliente.

Sintaxe

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

Parâmetros

BindingHandle

Chame para testar os comandos cancel. Se um valor igual a zero for especificado, o servidor representará o cliente que está sendo atendido por esse thread de servidor.

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi cancelada pelo cliente. O servidor ainda deve concluir ou anular a chamada.
RPC_S_NO_CALL_ACTIVE	Não há nenhuma chamada ativa no thread atual.
RPC_S_CALL_IN_PROGRESS	A chamada não foi cancelada.
RPC_S_INVALID_BINDING	O identificador não é válido.

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Comentários

O servidor chama RpcServerTestCancel para descobrir se o cliente solicitou o cancelamento de uma chamada pendente. A função RpcServerTestCancel indica apenas se um cliente cancelou a chamada; O estado não é alterado no servidor ou no cliente. A chamada cancelada ainda deve ser concluída ou anulada pelo servidor RPC, usando as chamadas de função RpcAsyncCompleteCall ou RpcAsyncAbortCall , respectivamente.

O parâmetro BindingHandle especifica a chamada na qual testar. Se o parâmetro tiver um valor igual a zero, a chamada no thread atual será testada. O servidor pode chamar a função RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) para testar uma mensagem de cancelamento usando o identificador assíncrono para obter o identificador de associação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rpcdce.h (inclua Rpc.h)
Biblioteca	Rpcrt4.lib
DLL	Rpcrt4.dll