Funzione WsCreateListener (webservices.h)

Articolo
08/27/2023

Crea un listener con le proprietà specificate.

Sintassi

HRESULT WsCreateListener(
  [in]           WS_CHANNEL_TYPE               channelType,
  [in]           WS_CHANNEL_BINDING            channelBinding,
                 const WS_LISTENER_PROPERTY    *properties,
  [in]           ULONG                         propertyCount,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 WS_LISTENER                   **listener,
  [in, optional] WS_ERROR                      *error
);

Parametri

[in] channelType

Tipo di canale per cui il listener è in ascolto. Per i tipi di canale, vedere l'enumerazione WS_CHANNEL_TYPE .

[in] channelBinding

Protocollo del canale per il listener. Per le associazioni possibili, vedere l'enumerazione WS_CHANNEL_BINDING .

properties

Puntatore a una struttura WS_LISTENER_PROPERTY contenente proprietà facoltative per il listener.

Per informazioni sulle proprietà che è possibile specificare durante la creazione di un listener, vedere l'enumerazione WS_LISTENER_PROPERTY_ID .

Per informazioni sulla creazione di un listener personalizzato, vedere la sezione Osservazioni.

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

[in, optional] securityDescription

Puntatore a una struttura WS_SECURITY_DESCRIPTION che specifica la sicurezza per il listener.

Se si crea un canale personalizzato (usando il valore WS_CUSTOM_CHANNEL_BINDING dell'enumerazione WS_CHANNEL_BINDING ), la descrizione della sicurezza deve essere NULL. Vedere la sezione relativa alle osservazioni.

listener

In caso di esito positivo, un puntatore che riceve l'indirizzo della struttura WS_LISTENER che rappresenta il nuovo listener.

[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
WS_E_QUOTA_EXCEEDED	È stata superata una quota.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_INVALIDARG	Uno o più argomenti non sono validi.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Quando si crea un listener personalizzato (usando il valore WS_CUSTOM_CHANNEL_BINDING dell'enumerazione WS_CHANNEL_BINDING ), è possibile specificare solo le proprietà del canale seguenti:

WS_LISTENER_PROPERTY_CUSTOM_LISTENER_CALLBACKS
WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS

Vedere l'enumerazione WS_LISTENER_PROPERTY_ID . Se sono necessarie altre proprietà iniziali per creare il listener personalizzato, specificarle usando la proprietà WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS.

Per passare le informazioni di sicurezza a un'implementazione del listener personalizzata, usare il valore WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS dell'enumerazione WS_LISTENER_PROPERTY_ID .

Requisiti


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