WS_CREATE_CHANNEL_CALLBACK funzione di callback (webservices.h)

Articolo
08/27/2023

Gestisce la chiamata WsCreateChannel per una WS_CUSTOM_CHANNEL_BINDING.

Sintassi

WS_CREATE_CHANNEL_CALLBACK WsCreateChannelCallback;

HRESULT WsCreateChannelCallback(
  [in]           WS_CHANNEL_TYPE channelType,
                 const void *channelParameters,
  [in]           ULONG channelParametersSize,
                 void **channelInstance,
  [in, optional] WS_ERROR *error
)
{...}

Parametri

[in] channelType

Modello di scambio dei messaggi del canale.

Se il tipo di canale non è supportato dall'implementazione del canale personalizzato, E_INVALIDARG deve essere restituito.

channelParameters

Puntatore al valore specificato dalla proprietà WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS quando il canale personalizzato viene creato usando WsCreateChannel.

Se la proprietà WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS non è stata specificata, il valore sarà NULL.

[in] channelParametersSize

Dimensione in byte del valore a cui punta channelParameters.

Se la proprietà WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS non è stata specificata, la dimensione sarà 0.

channelInstance

Puntatore a una struttura allocata dal callback che contiene i dati specifici di questa istanza del canale. Questo puntatore verrà passato a tutti gli altri callback del canale per questa particolare istanza del canale.

Se il callback ha esito positivo, il WS_FREE_CHANNEL_CALLBACK verrà usato per liberare l'istanza del canale restituita in questo parametro.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.
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

Condividi tramite