Funzione WsCreateServiceHost (webservices.h)

Articolo
08/27/2023

Crea un host del servizio per gli endpoint specificati.

Sintassi

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
);

Parametri

endpoints

Matrice di strutture WS_SERVICE_ENDPOINT che rappresentano gli endpoint di servizio per i quali creare l'host del servizio.

[in] endpointCount

Numero di endpoint nella matrice di endpoint .

serviceProperties

Matrice di strutture WS_SERVICE_PROPERTY contenenti proprietà facoltative per l'host del servizio.

Il valore di questo parametro può essere NULL, nel qual caso il parametro servicePropertyCount deve essere 0 (zero).

[in] servicePropertyCount

Numero di proprietà nella matrice serviceProperties .

serviceHost

In caso di esito positivo, un puntatore che riceve l'indirizzo della struttura WS_SERVICE_HOST che rappresenta il nuovo host del servizio.

Quando questa struttura non è più necessaria, è necessario liberarla chiamando WsFreeServiceHost.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Codice restituito	Descrizione
E_INVALIDARG	Per la creazione dell'host del servizio viene specificato un argomento non valido.
WS_E_QUOTA_EXCEEDED	È stata superata una quota.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite