WsAbortChannel-Funktion (webservices.h)

  • Artikel

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

Syntax

HRESULT WsAbortChannel(
  [in]           WS_CHANNEL *channel,
  [in, optional] WS_ERROR   *error
);

Parameter

[in] channel

Ein Zeiger auf eine WS_CHANNEL-Struktur , die den Kanal 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.

Rückgabecode Beschreibung
WS_E_NOT_SUPPORTED
 Informationen zu Plattformbeschränkungen finden Sie im Abschnitt Hinweise.
E_INVALIDARG
 Mindestens ein Argument ist ungültig.

Hinweise

Windows Server 2003 und früher: Auf Windows-Plattformen vor Windows Vista wird diese Funktion für WS_UDP_CHANNEL_BINDING oder WS_HTTP_CHANNEL_BINDING nicht unterstützt, wenn sich der Kanal im WS_CHANNEL_STATE_ACCEPTING Zustand befindet und der Listener noch nicht abgebrochen wurde.

(Informationen zu Kanalbindungen und Kanalzuständen finden Sie in den WS_CHANNEL_BINDING - und WS_CHANNEL_STATE-Enumerationen .)

Diese Funktion wird auch für WS_HTTP_CHANNEL_BINDING mit WS_CHANNEL_TYPE_REPLY beim Abbrechen eines Kanals im WS_CHANNEL_STATE_OPEN- oder WS_CHANNEL_STATE_FAULTED-Zustand nicht unterstützt. (Informationen zu Kanaltypen finden Sie in der WS_CHANNEL_TYPE-Enumeration .

WsAbortChannel kann für einen Kanal in einem beliebigen Zustand aufgerufen werden und wartet nicht, bis ausstehende E/A abgeschlossen ist, bevor der Kanal abgebrochen wird.

Wenn sich der Kanal im WS_CHANNEL_STATE_OPEN Zustand befindet, bewirkt WsAbortChannel , dass der Kanal den WS_CHANNEL_STATE_FAULTED Zustand aufweist.

Hinweis Informationen zum Überspringen einer bestimmten Nachricht und zum Offenhalten des Kanals finden Sie unter WsAbandonMessage .

 
Wenn diese Funktion mit gültigen Parametern aufgerufen wird, schlägt diese Funktion nicht fehl, z. B. aufgrund fehlender Systemressourcen. Beachten Sie jedoch die Einschränkungen für einige Betriebssystemversionen am Anfang der Hinweise.

Anforderungen

   
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