Funzione WsCreateChannelForListener (webservices.h)

Articolo
03/13/2024

Crea un canale associato a un listener specificato.

Sintassi

HRESULT WsCreateChannelForListener(
  [in]           WS_LISTENER               *listener,
                 const WS_CHANNEL_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_CHANNEL                **channel,
  [in, optional] WS_ERROR                  *error
);

Parametri

[in] listener

Puntatore a una struttura WS_LISTENER che rappresenta il listener per cui creare un canale. Il listener può essere in qualsiasi stato. Per gli stati del listener, vedere l'enumerazione WS_LISTENER_STATE .

properties

Matrice di strutture WS_CHANNEL_PROPERTY contenenti valori facoltativi per l'inizializzazione del canale. Questo può essere null, in tal caso, il parametro propertyCount deve essere 0 (zero).

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

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

channel

In caso di esito positivo, un puntatore che riceve l'indirizzo del canale creato.
Quando il canale non è più necessario, è necessario liberarlo chiamando WsFreeChannel.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni di errore aggiuntive 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	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
Altri errori	Questa funzione può restituire altri errori non elencati sopra.

Commenti

Per accettare uno scambio di messaggi in ingresso, chiamare la funzione WsAcceptChannel .

Le caratteristiche di sicurezza del canale sono uguali a quelle specificate per il listener.

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

WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS

Se sono necessarie proprietà iniziali per creare il canale personalizzato, specificarle usando la proprietà WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS.

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