WsAbortServiceProxy-Funktion (webservices.h)

Artikel
03/06/2024

Bricht den Dienstproxy ab und bricht alle ausstehenden E/A-Vorgänge auf dem Dienstproxy ab.

Syntax

HRESULT WsAbortServiceProxy(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in, optional] WS_ERROR         *error
);

Parameter

[in] serviceProxy

Zeiger auf eine WS_SERVICE_PROXY-Struktur , die den abzubrechenden Dienstproxy darstellt.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument ist ungültig.

Hinweise

WsAbortServiceProxy zeigt das folgende Verhalten in Abhängigkeit vom Status des Dienstproxys an (mögliche Zustände finden Sie in der WS_SERVICE_PROXY_STATE-Enumeration ):

Wenn der Dienstproxy geöffnet wird und sich im zustand WS_SERVICE_PROXY_STATE_OPENING befindet, können Sie WsAbortServiceProxy aufrufen, um den Öffnungsvorgang abzubrechen. Der Dienstproxy bricht alle ausstehenden E/A-Vorgänge ab und wechselt zurück in WS_SERVICE_PROXY_STATE_CREATED Zustand.
Wenn der Dienstproxy bereits geöffnet ist und sich im WS_SERVICE_PROXY_STATE_OPEN Zustand befindet, bewirkt WsAbortServiceProxy , dass der Dienstproxy alle zugrunde liegenden Kanäle abbricht und in den WS_SERVICE_PROXY_STATE_FAULTED Zustand wechselt. Sobald der Abbruch initiiert wurde, akzeptiert der Dienstproxy keine neuen Aufrufe. Die Anwendung kann WsCloseServiceProxy aufrufen, um sie zu schließen.
Wenn der Dienstproxy geschlossen wird und sich im WS_SERVICE_PROXY_STATE_CLOSING Zustand befindet, werden alle zugrunde liegenden Kanäle abgebrochen, und der Dienstproxy wechselt in den WS_SERVICE_PROXY_STATE_CLOSED Zustand.

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter ServiceCancellationExample.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll

Freigeben über