Funzione WsOpenServiceHost (webservices.h)

Articolo
03/13/2024

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

Share via