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