WebhostOpenListenerChannelInstance Function

Meminta agar saluran pendengar dimulai dalam proses pekerja untuk kumpulan aplikasi ini.

Sintaks

HRESULT WebhostOpenListenerChannelInstance(  
   IN DWORD ProtocolHandle,  
   IN LPCWSTR AppPoolId,  
   IN DWORD ListenerChannelId,  
   IN PBYTE ListenerChannelBlob,  
   IN DWORD ListenerChannelBlobByteCount  
);  

Parameter

ProtocolHandle
[IN] DWORD yang berisi handel protokol untuk saluran pendengar.

AppPoolId
[IN] String yang berisi ID kumpulan aplikasi untuk saluran pendengar.

ListenerChannelId
[IN] DWORD yang berisi pengidentifikasi saluran pendengar.

ListenerChannelBlob
[IN] PBYTE yang berisi informasi yang diperlukan untuk menyambungkan proses pekerja ke pendengar. Data tidak terlihat oleh Layanan Aktivasi Proses Windows (WAS). Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

ListenerChannelBlobByteCount
[IN] DWORD yang berisi jumlah byte di BLOB saluran pendengar.

Tampilkan Nilai

Sebuah HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Nilai	Deskripsi
S_OK	Menunjukkan bahwa operasi berhasil.
E_INVALIDARG	Menunjukkan bahwa salah satu parameter tidak valid.
HRESULT_FROM_WIN32( ERROR_NOT_FOUND)	Menunjukkan bahwa protokol belum didaftarkan.
HRESULT_FROM_WIN32(ERROR_PIPE_NOT_CONNECTED)	Menunjukkan bahwa adaptor pendengar tidak tersambung ke Layanan Aktivasi Proses Windows.

Keterangan

Fungsi ini dipanggil ketika saluran pendengar menerima permintaan pertamanya, atau ketika Layanan Aktivasi Proses Windows memberi tahu adaptor pendengar bahwa ia dapat memulai instans lain dari saluran pendengar.

Parameter ListenerChannelBlob diteruskan ke Layanan Aktivasi Proses Windows, proses pekerja, dan manajer protokol. Jika adaptor pendengar merutekan permintaan per aplikasi, BLOB mungkin akan berisi kunci aplikasi yang perlu diteruskan oleh penangan protokol proses ke manajer protokol. Manajer protokol memerlukan kunci aplikasi agar penangan protokol domain aplikasi terhubung. Detail BLOB diserahkan ke penulis protokol.

Secara default, Layanan Aktivasi Proses Windows menetapkan proses daur ulang yang tumpang tindih, di mana proses pekerja yang akan dimatikan terus berjalan sampai setelah proses pekerja baru dimulai. Layanan Aktivasi Proses Windows menyimpan BLOB saluran pendengar dan akan menggunakannya untuk meminta proses pekerja baru untuk terhubung. Ini berarti bahwa saluran pendengar harus dapat menerima beberapa proses yang terhubung ke saluran pendengar.

Layanan Aktivasi Proses Windows tidak mengelola bagaimana saluran pendengar berhubungan dengan aplikasi (misalnya, pendengar dapat memilih untuk memiliki banyak saluran pendengar per kumpulan aplikasi atau hanya satu). Oleh karena itu, Layanan Aktivasi Proses Windows tidak dapat menentukan adaptor pendengar apa yang harus terjadi pada saluran pendengar ketika perubahan terjadi. Layanan Aktivasi Proses Windows hanya akan memberi tahu adaptor pendengar dan memungkinkannya mengelola keputusan tersebut.

Anda harus mengatur daftar kontrol akses (ACL) saluran pendengar ke identitas kumpulan aplikasi.

Persyaratan

Jenis	Deskripsi
Klien	- IIS 7.0 di Windows Vista - IIS 7.5 di Windows 7 - IIS 8.0 di Windows 8 - IIS 10.0 pada Windows 10
Server	- IIS 7.0 di Windows Server 2008 - IIS 7.5 di Windows Server 2008 R2 - IIS 8.0 di Windows Server 2012 - IIS 8.5 di Windows Server 2012 R2 - IIS 10.0 di Windows Server 2016
Produk	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Listeneradapter.h

Lihat juga

Fungsi Yang Diekspor Adaptor Listener