RpcServerTestCancel-Funktion (rpcdce.h)
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 |
|---|---|
|
Der Aufruf wurde vom Client abgebrochen. Der Server muss den Aufruf trotzdem abschließen oder abbrechen. |
|
Für den aktuellen Thread gibt es keinen aktiven Aufruf. |
|
Der Anruf wurde nicht abgebrochen. |
|
Das Handle ist ungültig. |
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 |