RpcServerTestCancel-Funktion (rpcdce.h)

Artikel
08/25/2023

Der Server ruft RpcServerTestCancel auf, um auf Clientabbruchanforderungen zu testen.

Syntax

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

Parameter

BindingHandle

Aufruf zum Testen auf Abbrechen von Befehlen. Wenn ein Wert von 0 angegeben wird, gibt der Server die Identität des Clients an, der von diesem Serverthread bedient wird.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf wurde vom Client abgebrochen. Der Server muss den Aufruf trotzdem abschließen oder abbrechen.
RPC_S_NO_CALL_ACTIVE	Für den aktuellen Thread gibt es keinen aktiven Aufruf.
RPC_S_CALL_IN_PROGRESS	Der Anruf wurde nicht abgebrochen.
RPC_S_INVALID_BINDING	Das Handle ist ungültig.

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

Hinweise

Der Server ruft RpcServerTestCancel auf, um herauszufinden, ob der Client die Abbruch eines ausstehenden Anrufs angefordert hat. Die RpcServerTestCancel-Funktion gibt nur an, ob ein Client den Aufruf abgebrochen hat. Der Zustand wird auf dem Server oder Client nicht geändert. Der abgebrochene Aufruf muss weiterhin vom RPC-Server mithilfe von RpcAsyncCompleteCall - bzw . RpcAsyncAbortCall-Funktionsaufrufen abgeschlossen oder abgebrochen werden.

Der BindingHandle-Parameter gibt den Aufruf an, an dem getestet werden soll. Wenn der Parameter den Wert 0 aufweist, wird der Aufruf für den aktuellen Thread getestet. Der Server kann die Funktion RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) aufrufen, um mithilfe des asynchronen Handles zum Abrufen des Bindungshandles auf eine Abbruchmeldung zu testen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll