WsCreateServiceHost-Funktion (webservices.h)

  • Artikel

Erstellt einen Diensthost für die angegebenen Endpunkte.

Syntax

HRESULT WsCreateServiceHost(
                 const WS_SERVICE_ENDPOINT **endpoints,
  [in]           const USHORT              endpointCount,
                 const WS_SERVICE_PROPERTY *serviceProperties,
  [in]           ULONG                     servicePropertyCount,
                 WS_SERVICE_HOST           **serviceHost,
  [in, optional] WS_ERROR                  *error
);

Parameter

endpoints

Ein Array von WS_SERVICE_ENDPOINT Strukturen, die die Dienstendpunkte darstellen, für die der Diensthost erstellt werden soll.

[in] endpointCount

Die Anzahl der Endpunkte im Endpunktarray .

serviceProperties

Ein Array von WS_SERVICE_PROPERTY Strukturen, die optionale Eigenschaften für den Diensthost enthalten.

Der Wert dieses Parameters kann NULL sein. In diesem Fall muss der servicePropertyCount-Parameter 0 (Null) sein.

[in] servicePropertyCount

Die Anzahl der Eigenschaften im ServiceProperties-Array .

serviceHost

Bei Erfolg ein Zeiger, der die Adresse der WS_SERVICE_HOST-Struktur empfängt, die den neuen Diensthost darstellt.

Wenn Sie diese Struktur nicht mehr benötigen, müssen Sie sie durch Aufrufen von WsFreeServiceHost freigeben.

[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
E_INVALIDARG
 Zum Erstellen des Diensthosts wird ein ungültiges Argument angegeben.
WS_E_QUOTA_EXCEEDED
 Ein Kontingent wurde überschritten.
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

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