WsAbortServiceProxy-Funktion (webservices.h)

  • Artikel

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