Bagikan melalui

IWSDDeviceHost::Metode init (wsdhost.h)

  • Artikel

Menginisialisasi instans objek IWSDDeviceHost , yang merupakan representasi sisi host perangkat.

Sintaks

HRESULT Init(
  [in]           LPCWSTR        pszLocalId,
  [in, optional] IWSDXMLContext *pContext,
  [in, optional] IWSDAddress    **ppHostAddresses,
  [in, optional] DWORD          dwHostAddressCount
);

Parameter

[in] pszLocalId

Alamat logis atau fisik perangkat. Alamat logis adalah dari formulir urn:uuid:{guid}. Jika pszLocalId adalah alamat logis, host akan mengumumkan alamat logis lalu mengonversi alamat ke alamat fisik saat menerima pesan Resolve atau Probe.

Jika pszLocalId adalah alamat fisik (seperti URL yang diawali oleh http atau https), host akan menggunakan alamat sebagai alamat fisik dan akan menghosting pada alamat tersebut alih-alih alamat default.

Untuk komunikasi yang aman, pszLocalId harus berupa URL yang diawali oleh https, dan host akan menggunakan protokol SSL/TLS pada port yang ditentukan dalam URL. Port yang direkomendasikan adalah port 5358, karena port ini dicadangkan untuk koneksi aman dengan WSDAPI. Jika tidak ada port yang ditentukan, maka host akan menggunakan port 443. Port host harus dikonfigurasi dengan sertifikat server SSL. Untuk informasi selengkapnya tentang konfigurasi port host, lihat HttpSetServiceConfiguration.

URL apa pun (http atau https) harus dihentikan dengan garis miring berikutnya. URL harus berisi alamat IP atau nama host yang valid.

Daftar berikut ini memperlihatkan beberapa contoh nilai untuk pszLocalId. Ini bukan daftar lengkap nilai yang valid.

  • http://192.168.0.1:5357/
  • http://localhost/
  • http://myHostname:5357/
  • https://192.168.0.1:5358/
  • https://myHostname/
  • https://myHostname/myDevice/
  • https://myHostname:5358/

[in, optional] pContext

Antarmuka IWSDXMLContext yang menentukan jenis pesan kustom atau namespace layanan.

[in, optional] ppHostAddresses

Objek IWSDAddress tunggal atau objek IWSDTransportAddress . Objek memberikan informasi tentang alamat tertentu yang harus didengarkan host.

Jika pszLocalId berisi alamat lokal, perilaku yang dihasilkan adalah pemetaan antara alamat logis dan alamat fisik yang disediakan (alih-alih pemetaan antara alamat logis dan alamat fisik default).

[in, optional] dwHostAddressCount

Jumlah item dalam array ppHostAddresses . Jika ppHostAddresses adalah antarmuka IWSDAddress , jumlahnya harus 1.

Nilai kembali

Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini:

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_INVALIDARG
 pszLocalId adalah NULL, panjang karakter pszLocalId melebihi WSD_MAX_TEXT_LENGTH (8192), atau jumlah alamat yang direferensikan oleh ppHostAddresses tidak cocok dengan dwHostAddressCount.
E_FAIL
 Host perangkat dalam keadaan tidak terduga.
E_OUTOFMEMORY
 Tidak cukup memori untuk menyelesaikan operasi.
E_ABORT
 Inisialisasi tidak dapat diselesaikan.

Keterangan

Metode ini dipanggil oleh WSDCreateDeviceHost dan biasanya tidak perlu dipanggil langsung oleh kode Anda.

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)
DLL Wsdapi.dll

Lihat juga

IWSDDeviceHost