WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK fungsi panggilan balik (webservices.h)

Artikel
03/13/2024

Menangani panggilan WsCreateChannelForListener untuk WS_CUSTOM_CHANNEL_BINDING.

Sintaks

WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK WsCreateChannelForListenerCallback;

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

Parameter

[in] listenerInstance

Penunjuk ke status khusus untuk instans pendengar ini, seperti yang dibuat oleh WS_CREATE_LISTENER_CALLBACK.

channelParameters

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

Jika properti WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS tidak ditentukan, nilainya adalah NULL.

[in] channelParametersSize

Ukuran dalam byte nilai yang diacu 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 tempat 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 Lain	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Lihat WsCreateChannelForListener untuk informasi tentang kontrak API ini.

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

Share via