WsAbortListener-Funktion (webservices.h)

  • Artikel

Bricht alle ausstehenden E/A-Vorgänge für den angegebenen Listener ab.

Syntax

HRESULT WsAbortListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

Parameter

[in] listener

Zeiger auf eine WS_LISTENER Struktur, die den Listener darstellt, für den E/A abgebrochen werden soll.

[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.

Hinweise

WsAbortListener kann aufgerufen werden, wenn sich der Listener in einem beliebigen Zustand befindet. (Mögliche Zustände finden Sie in der WS_LISTENER_STATE-Enumeration .) Wenn sich der Listener im WS_LISTENER_STATE_OPEN Zustand befindet, erzwingt diese Funktion einen Fehler beim Listener (Zurücksetzen auf den WS_LISTENER_STATE_FAULTED Zustand). Wenn ein Listener fehlerhaft ist, schlagen alle Versuche, eine Nachricht von diesem zu akzeptieren, sofort mit dem WS_E_OBJECT_FAULTED Fehlercode fehl.

Diese Funktion wartet nicht, bis ausstehende E/A-Vorgänge abgeschlossen sind.

Wenn diese Funktion mit gültigen Parametern aufgerufen wird, schlägt diese Funktion nicht fehl, z. B. aufgrund fehlender Systemressourcen.

Anforderungen

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