WsOpenServiceHost-Funktion (webservices.h)

  • Artikel

Öffnet einen Diensthost für die Kommunikation und startet die Listener auf allen Endpunkten. Clientanwendungen können erst dann eine Verbindung mit Dienstendpunkten herstellen, wenn WsOpenSerivceHost aufgerufen wird.

Syntax

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

Parameter

[in] serviceHost

Ein Zeiger auf das zu öffnende Diensthostobjekt . Der Zeiger muss auf ein gültiges WS_SERVICE_HOST Objekt verweisen, das von WsCreateServiceHost zurückgegeben wird, und der Diensthostwert , auf den verwiesen wird, ist möglicherweise nicht NULL.

[in, optional] asyncContext

Ein Zeiger auf A WS_ASYNC_CONTEXT -Objekt, das Informationen zum asynchronen Aufrufen der Funktion enthält. Der Wert wird auf NULL festgelegt, wenn synchron aufgerufen wird.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
WS_S_ASYNC
 Der asynchrone Vorgang steht noch aus.
WS_E_OPERATION_ABORTED
 Der Diensthost wurde vor dem Öffnen oder während des Öffnens abgebrochen.
WS_E_INVALID_OPERATION
 Der aktuelle Status des Dienstproxys ist für diesen Vorgang ungültig.
WS_E_ADDRESS_IN_USE
 Die Adresse wird bereits verwendet.
WS_E_ADDRESS_NOT_AVAILABLE
 Die Adresse ist für diesen Kontext ungültig.
WS_E_QUOTA_EXCEEDED
 Ein Kontingent wurde überschritten.
WS_E_OPERATION_ABORTED
 Der Vorgang wurde abgebrochen.
WS_E_OPERATION_TIMED_OUT
 Der Vorgang wurde innerhalb der zugewiesenen Zeit nicht abgeschlossen.
E_OUTOFMEMORY
 Der Arbeitsspeicher ist nicht mehr vorhanden.
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Beachten Sie, dass alle Endpunktlistener erfolgreich geöffnet werden müssen, bevor ein Kanal vom Diensthost für die Kommunikation mit dem Client akzeptiert wird.

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