Condividi tramite


Funzione WsOpenServiceHost (webservices.h)

Apre un host del servizio per la comunicazione e avvia i listener in tutti gli endpoint. Le applicazioni client non possono connettersi agli endpoint di servizio finché non viene chiamato WsOpenSerivceHost .

Sintassi

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

Parametri

[in] serviceHost

Puntatore all'oggetto Host del servizio da aprire. Il puntatore deve fare riferimento a un oggetto WS_SERVICE_HOST valido restituito da WsCreateServiceHost e il valore host del servizio a cui si fa riferimento potrebbe non essere NULL.

[in, optional] asyncContext

Puntatore a un oggetto WS_ASYNC_CONTEXT che contiene informazioni su come richiamare la funzione in modo asincrono. Il valore è impostato su NULL se si richiama in modo sincrono.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito Descrizione
WS_S_ASYNC
L'operazione asincrona è ancora in sospeso.
WS_E_OPERATION_ABORTED
L'host del servizio è stato interrotto prima dell'apertura o durante l'apertura.
WS_E_INVALID_OPERATION
Lo stato corrente del proxy del servizio non è valido per questa operazione.
WS_E_ADDRESS_IN_USE
L'indirizzo è già in uso.
WS_E_ADDRESS_NOT_AVAILABLE
L'indirizzo non è valido per questo contesto.
WS_E_QUOTA_EXCEEDED
È stata superata una quota.
WS_E_OPERATION_ABORTED
L'operazione è stata interrotta.
WS_E_OPERATION_TIMED_OUT
L'operazione non è stata completata entro il tempo assegnato.
E_OUTOFMEMORY
Memoria insufficiente.
E_INVALIDARG
Uno o più argomenti non sono validi.
Altri errori
Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Si noti che tutti i listener degli endpoint devono essere aperti correttamente prima che qualsiasi canale venga accettato dall'host del servizio per comunicare con il client.

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