WsCloseServiceHost-Funktion (webservices.h)

Artikel
03/06/2024

Schließt die Kommunikation mit dem angegebenen Diensthost.

Syntax

HRESULT WsCloseServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] serviceHost

Zeiger auf eine WS_SERVICE_HOST-Struktur , die den zu schließenden Diensthost darstellt.

[in, optional] asyncContext

Zeiger auf eine WS_ASYNC_CONTEXT Struktur, die Informationen zum asynchronen Aufrufen der Funktion enthält. Übergeben Sie NULL , um die Funktion synchron aufzurufen.

[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_S_ASYNC	Der asynchrone Vorgang steht noch aus.
WS_E_INVALID_OPERATION	Der aktuelle Status des Diensthosts ist für diesen Vorgang ungültig.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
WS_E_OPERATION_TIMED_OUT	Der Vorgang wurde innerhalb der zugewiesenen Zeit nicht abgeschlossen.
WS_E_OPERATION_ABORTED	Der Vorgang wurde abgebrochen.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

WsCloseServiceHost schließt alle Listener auf dem Diensthost. Daher werden keine neuen Kanäle vom Client akzeptiert. Ausstehende E/A-Vorgänge auf bereits akzeptierten Kanälen können jedoch abgeschlossen werden.

Dies hat Auswirkungen auf Endpunkte, die für die Ausführung mit sitzungsbasierten Kanalbindungen konfiguriert sind. Wenn ein Client über eine offene Sitzung mit einem Dienst an einem solchen Endpunkt verfügt, wird die Schließung erst abgeschlossen, wenn der Client die Sitzung mit dem Dienst schließt.

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

Freigeben über