WsAbortServiceHost-Funktion (webservices.h)

Bricht alle aktuellen Vorgänge auf dem angegebenen Diensthost ab.

Syntax

HRESULT WsAbortServiceHost(
  [in]           WS_SERVICE_HOST *serviceHost,
  [in, optional] WS_ERROR        *error
);

Parameter

[in] serviceHost

Zeiger auf eine WS_SERVICE_HOST Struktur, die den Diensthost darstellt, auf dem Vorgänge abgebrochen werden sollen.

[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, gibt sie NO_ERROR zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

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

Hinweise

WsAbortServiceHost bricht alle Listener auf dem Diensthost ab, und infolgedessen werden keine neuen Kanäle vom Client akzeptiert. Alle Kanäle, die derzeit vom Diensthost für Dienstnachrichten verwendet werden, werden ebenfalls abgebrochen.

Wenn ein Aufruf aussteht und ein Rückruf zum Abbrechen über die WsRegisterOperationForCancel-Funktion registriert ist, wird der Rückruf aufgerufen. Die Laufzeit wartet jedoch weiterhin, bis der Aufruf abgeschlossen ist.

Weitere Informationen zur Registrierung für Abbruchbenachrichtigungen finden Sie unter WsRegisterOperationForCancel.

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