Antarmuka IWSDDeviceHost (wsdhost.h)
Mewakili perangkat yang mematuhi DPWS . Host perangkat akan mengumumkan kehadirannya di jaringan menggunakan protokol WS-Discovery. Host perangkat juga akan secara otomatis menanggapi kueri penemuan dan permintaan metadata.
Pemanggil dapat mendaftarkan layanan yang diterapkan pengguna dengan host perangkat. Layanan ini akan diekspos dalam metadata perangkat dan layanan akan tersedia melalui jaringan. Pesan yang terikat untuk layanan ini akan secara otomatis dikirim ke objek layanan.
Panggil WSDCreateDeviceHost atau WSDCreateDeviceHostAdvanced untuk membuat objek yang mengekspos antarmuka ini.
Warisan
Antarmuka IWSDDeviceHost mewarisi dari antarmuka IUnknown . IWSDDeviceHost juga memiliki jenis anggota ini:
Metode
Antarmuka IWSDDeviceHost memiliki metode ini.
| IWSDDeviceHost::AddDynamicService Mendaftarkan objek layanan untuk permintaan masuk, tetapi tidak menambahkan layanan ke metadata host perangkat. Ini digunakan untuk layanan sementara (dinamis). |
| IWSDDeviceHost::Init Menginisialisasi instans objek IWSDDeviceHost. |
| IWSDDeviceHost::RegisterPortType Mendaftarkan tipe port untuk pesan masuk. |
| IWSDDeviceHost::RegisterService Mendaftarkan objek layanan untuk permintaan masuk dan menambahkan layanan ke metadata host perangkat. |
| IWSDDeviceHost::RemoveDynamicService Membatalkan pendaftaran objek layanan yang terdaftar menggunakan AddDynamicService. |
| IWSDDeviceHost::RetireService Membatalkan pendaftaran objek layanan yang terdaftar menggunakan RegisterService dan menghapus layanan dari metadata host perangkat. |
| IWSDDeviceHost::SetMetadata Mengatur metadata untuk perangkat, tidak termasuk metadata layanan yang ditentukan pengguna. |
| IWSDDeviceHost::SetServiceDiscoverable Mengontrol apakah layanan diiklankan menggunakan WS-Discovery atau tidak. |
| IWSDDeviceHost::SignalEvent Memberi tahu semua klien langganan bahwa suatu peristiwa telah terjadi. |
| IWSDDeviceHost::Start Memulai host perangkat dan menerbitkan host perangkat menggunakan pesan Halo WS-Discovery. |
| IWSDDeviceHost::Stop Mengirim pesan WS-Discovery Bye dan menghentikan host. |
| IWSDDeviceHost::Terminate Menghentikan host dan merilis layanan terlampir apa pun. |
Keterangan
Setelah mengambil antarmuka ini, aplikasi kemudian akan:
- Panggil metode RegisterPortType untuk mendaftarkan semua jenis port yang diperlukan.
- Panggil SetMetadata untuk menjelaskan perangkat dan secara opsional memanggil RegisterService satu atau beberapa kali untuk mendaftarkan layanan yang dijelaskan dalam metadata host layanan.
- Panggil metode Mulai untuk memulai host perangkat dan menerbitkan perangkat menggunakan WS-Discovery.Setelah memulai host perangkat, Anda dapat secara opsional:
- Panggil AddDynamicService untuk layanan yang tidak dijelaskan dalam metadata host layanan (misalnya, pekerjaan cetak ad hoc).
- Panggil RetireService untuk menghentikan tindakan dan memutuskan sambungan layanan yang diaktifkan oleh metode RegisterService .
- Panggil metode SignalEvent untuk menunjukkan bahwa pemberitahuan harus dikirim untuk langganan yang berkaitan dengan peristiwa tertentu.
- Panggil metode Hentikan untuk mengakhiri eksekusi host dan mengakhiri publikasi perangkat.
Objek IWSDDeviceHost dapat menyediakan objek untuk layanan sesuai permintaan (menggunakan panggilan balik pemberitahuan) saat memanggil host menerima pesan permintaan yang diarahkan ke layanan tersebut.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wsdhost.h (termasuk Wsdapi.h) |