WsAbortChannel-Funktion (webservices.h)

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.

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.

Anforderungen