RpcTestCancel-Funktion (rpcdce.h)

  • Artikel

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