Funzione RpcServerTestCancel (rpcdce.h)

Articolo
03/15/2023

Il server chiama RpcServerTestCancel per testare le richieste di annullamento del client.

Sintassi

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

Parametri

BindingHandle

Chiamare per testare i comandi annulla. Se viene specificato un valore pari a zero, il server rappresenta il client che viene servito da questo thread del server.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata è stata annullata dal client. Il server deve comunque completare o interrompere la chiamata.
RPC_S_NO_CALL_ACTIVE	Non è presente alcuna chiamata attiva al thread corrente.
RPC_S_CALL_IN_PROGRESS	La chiamata non è stata annullata.
RPC_S_INVALID_BINDING	L'handle non è valido.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

Il server chiama RpcServerTestCancel per scoprire se il client ha richiesto l'annullamento di una chiamata in sospeso. La funzione RpcServerTestCancel indica solo se un client ha annullato la chiamata; lo stato non viene modificato nel server o nel client. La chiamata annullata deve comunque essere completata o interrotta dal server RPC, usando rispettivamente le chiamate di funzione RpcAsyncCompleteCall o RpcAsyncAbortCall .

Il parametro BindingHandle specifica la chiamata su cui eseguire il test. Se il parametro ha un valore pari a zero, viene testata la chiamata al thread corrente. Il server può chiamare la funzione RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) per testare un messaggio di annullamento usando l'handle asincrono per ottenere l'handle di associazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll