Bagikan melalui

Antarmuka IWSDDeviceHost (wsdhost.h)

  • Artikel

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:

  1. Panggil metode RegisterPortType untuk mendaftarkan semua jenis port yang diperlukan.
  2. Panggil SetMetadata untuk menjelaskan perangkat dan secara opsional memanggil RegisterService satu atau beberapa kali untuk mendaftarkan layanan yang dijelaskan dalam metadata host layanan.
  3. Panggil metode Mulai untuk memulai host perangkat dan menerbitkan perangkat menggunakan WS-Discovery.Setelah memulai host perangkat, Anda dapat secara opsional:
    1. Panggil AddDynamicService untuk layanan yang tidak dijelaskan dalam metadata host layanan (misalnya, pekerjaan cetak ad hoc).
    2. Panggil RetireService untuk menghentikan tindakan dan memutuskan sambungan layanan yang diaktifkan oleh metode RegisterService .
    3. Panggil metode SignalEvent untuk menunjukkan bahwa pemberitahuan harus dikirim untuk langganan yang berkaitan dengan peristiwa tertentu.
  4. 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)

Lihat juga

Gambaran Umum Antarmuka WSDAPI