Função RpcTestCancel (rpcdce.h)

A função RpcTestCancel verifica se há uma indicação de cancelamento.

Sintaxe

RPC_STATUS RpcTestCancel();

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi cancelada.
Outros valores	A chamada não foi cancelada.

 

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

 

Não é incomum que a função RpcTestCancel retorne o valor ERROR_ACCESS_DENIED. Isso indica que a chamada de procedimento remoto não foi cancelada.

Comentários

Um stub do servidor de aplicativos chama RpcTestCancel para determinar se uma chamada foi cancelada. Se a chamada tiver sido cancelada, RPC_S_OK será retornado; caso contrário, outro valor será retornado.

Essa função deve ser chamada periodicamente pelo stub do servidor para que ela possa responder aos cancelamentos em tempo hábil. Se a função retornar RPC_S_OK, o stub deverá limpo suas estruturas de dados e retornar ao cliente.

Requisitos

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

Confira também

RpcServerTestCancel