WS_CREATE_CHANNEL_CALLBACK fungsi panggilan balik (webservices.h)

Artikel
03/09/2024

Menangani panggilan WsCreateChannel untuk WS_CUSTOM_CHANNEL_BINDING.

Sintaks

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
)
{...}

Parameter

[in] channelType

Pola pertukaran pesan saluran.

Jika jenis saluran tidak didukung oleh implementasi saluran kustom, E_INVALIDARG harus dikembalikan.

channelParameters

Penunjuk ke nilai yang ditentukan oleh properti WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS saat saluran kustom dibuat menggunakan WsCreateChannel.

Jika properti WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS tidak ditentukan, nilainya adalah NULL.

[in] channelParametersSize

Ukuran dalam byte nilai yang ditujukkan oleh channelParameters.

Jika properti WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS tidak ditentukan, ukurannya akan menjadi 0.

channelInstance

Penunjuk ke struktur yang dialokasikan oleh panggilan balik yang berisi data khusus untuk instans saluran ini. Pointer ini akan diteruskan ke semua panggilan balik saluran lainnya untuk instans saluran khusus ini.

Jika panggilan balik ini berhasil, maka WS_FREE_CHANNEL_CALLBACK akan digunakan untuk membebaskan instans saluran yang dikembalikan dalam parameter ini.

[in, optional] error

Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Kehabisan memori.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	webservices.h