WsCloseServiceHost-Funktion (webservices.h)

  • Artikel

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