Fungsi WebhostRegisterProtocol

Menyatakan protokol yang didukung adaptor pendengar.

Sintaks

HRESULT WebhostRegisterProtocol(  
   IN LPCWSTR ProtocolId,  
   IN VOID* pListenerCallbacks,  
   IN VOID* pContext,  
   OUT DWORD* pProtocolHandle  
);  

Parameter

ProtocolId
[IN] String yang berisi protokol yang didukung adaptor pendengar ini.

pListenerCallbacks
[IN] VOID Penunjuk ke struktur WEBHOST_LISTENER_CALLBACKS .

pContext
[IN] Penunjuk arbitrer VOID yang akan diteruskan oleh adaptor pendengar.

pProtocolHandle
[OUT] Penunjuk ke yang DWORD berisi kunci unik proses yang mewakili protokol ini.

Tampilkan Nilai

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

Nilai	Definisi
S_OK	Menunjukkan bahwa operasi berhasil.
HRESULT_FROM_WIN32( ERROR_ALREADY_EXISTS )	Menunjukkan sudah ada adaptor pendengar yang terdaftar dalam proses ini untuk protokol ini.
E_INVALIDARG	Menunjukkan bahwa salah satu parameter tidak valid.
E_OUTOFMEMORY	Menunjukkan bahwa memori tumpukan habis.

Keterangan

Anda harus memanggil fungsi terlebih WebhostRegisterProtocol dahulu saat memulai adaptor pendengar. WebhostRegisterProtocol asinkron, sehingga pengembalian yang berhasil tidak menjamin bahwa panggilan berhasil. Layanan Aktivasi Proses Windows (WAS) memberi tahu pendengar tentang keberhasilan pendaftaran dengan menggunakan fungsi PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED . PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED diteruskan dalam pListenerCallbacks parameter ke panggilan ini.

Anda harus mengatur waktu habis untuk adaptor pendengar untuk PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED menunggu fungsi panggilan balik. Jika waktu habis berakhir, Anda harus menghentikan layanan adaptor pendengar dan menandainya sebagai gagal. Pengembalian yang berhasil dari panggilan ini menunjukkan bahwa pustaka klien sedang menunggu Layanan Aktivasi Proses Windows dan akan tersambung jika memungkinkan.

Anda tidak boleh mengatur status layanan pendengar ke SERVICE_RUNNING dari fungsi panggilan balik ini. Anda harus mengatur status layanan ke SERVICE_RUNNING hanya ketika inisialisasi selesai dan pendengar protokol mendengarkan (biasanya setelah pemberitahuan PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED ).

Parameter pContext diteruskan ke adaptor pendengar setiap kali fungsi panggilan balik dipanggil. Ini dapat digunakan ketika beberapa protokol yang menggunakan struktur panggilan balik yang sama diimplementasikan.

Agar pustaka klien tersambung ke Layanan Aktivasi Proses Windows, kondisi berikut harus dipenuhi:

• Bagian <listenerAdapters> konfigurasi dalam file Was.config harus mendeklarasikan protokol dan identitas tempat adaptor pendengar akan berjalan.

• Layanan Aktivasi Proses Windows harus dijalankan.

• Layanan adaptor pendengar harus mendaftar tergantung pada Layanan Aktivasi Proses Windows.

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 PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED
Fungsi Yang Diekspor Listener Adapter