RpcTestCancel-Funktion (rpcdce.h)

Die RpcTestCancel-Funktion sucht nach einer Abbruchanzeige.

Syntax

RPC_STATUS RpcTestCancel();

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf wurde abgebrochen.
Andere Werte	Der Anruf wurde nicht abgebrochen.

 

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

 

Es ist nicht ungewöhnlich, dass die RpcTestCancel-Funktion den Wert ERROR_ACCESS_DENIED zurückgibt. Dies gibt an, dass der Remoteprozeduraufruf nicht abgebrochen wurde.

Hinweise

Ein Anwendungsserver-Stub ruft RpcTestCancel auf, um zu bestimmen, ob ein Anruf abgebrochen wurde. Wenn der Anruf abgebrochen wurde, wird RPC_S_OK zurückgegeben. Andernfalls wird ein anderer Wert zurückgegeben.

Diese Funktion sollte in regelmäßigen Abständen vom Serverstub aufgerufen werden, damit sie rechtzeitig auf Absagen reagieren kann. Wenn die Funktion RPC_S_OK zurückgibt, sollte der Stub seine Datenstrukturen sauber und zum Client zurückkehren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (rpc.h einschließen)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

RpcServerTestCancel