Bagikan melalui

Metode IWSDiscoveryPublisher::P ublish (wsddisco.h)

  • Artikel

Mengumumkan kehadiran host jaringan dengan mengirim pesan Halo .

Sintaks

HRESULT Publish(
  [in]           LPCWSTR             pszId,
  [in]           ULONGLONG           ullMetadataVersion,
  [in]           ULONGLONG           ullInstanceId,
  [in]           ULONGLONG           ullMessageNumber,
  [in, optional] LPCWSTR             pszSessionId,
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] const WSD_URI_LIST  *pXAddrsList
);

Parameter

[in] pszId

Alamat logis atau fisik perangkat, yang digunakan sebagai alamat titik akhir perangkat. Alamat logis adalah dari formulir urn:uuid:{guid}. Alamat fisik dapat menjadi URI yang diawali oleh http atau https, atau hanya URI yang diawali oleh uri. Jika memungkinkan, gunakan alamat logis.

[in] ullMetadataVersion

Versi metadata saat ini.

Catatan Untuk kompatibilitas dengan spesifikasi WS-Discovery, nilai ini harus kurang dari atau sama dengan UINT_MAX (4294967295).
 

[in] ullInstanceId

Pengidentifikasi untuk instans perangkat saat ini yang sedang diterbitkan. Pengidentifikasi ini harus dinaikkan setiap kali layanan dimulai ulang. Untuk informasi selengkapnya tentang pengidentifikasi instans, lihat Lampiran I spesifikasi WS-Discovery.

Catatan Untuk kompatibilitas dengan spesifikasi WS-Discovery, nilai ini harus kurang dari atau sama dengan UINT_MAX (4294967295).
 

[in] ullMessageNumber

Penghitung dalam cakupan pengidentifikasi instans untuk pesan saat ini. Nomor pesan harus bertahap untuk setiap pesan.

Catatan Untuk kompatibilitas dengan spesifikasi WS-Discovery, nilai ini harus kurang dari atau sama dengan UINT_MAX (4294967295).
 

[in, optional] pszSessionId

Pengidentifikasi unik dalam cakupan pengidentifikasi instans untuk sesi saat ini. Parameter ini sesuai dengan pengidentifikasi urutan di blok AppSequence dalam pesan Probe. Untuk informasi selengkapnya tentang pengidentifikasi urutan, lihat Lampiran I spesifikasi WS-Discovery.

Parameter ini mungkin NULL.

[in, optional] pTypesList

Penunjuk ke struktur WSD_NAME_LIST yang mewakili daftar jenis yang didukung oleh host penerbitan. Mungkin NULL.

[in, optional] pScopesList

Penunjuk ke struktur WSD_URI_LIST yang mewakili daftar cakupan yang cocok yang didukung oleh host penerbitan. Daftar berisi nilai hash dalam bentuk string. Mungkin NULL.

[in, optional] pXAddrsList

Penunjuk ke struktur WSD_URI_LIST yang mewakili daftar alamat transportasi yang didukung oleh host penerbitan. Setiap string alamat transportasi berisi alamat dan nomor port yang dapat digunakan untuk koneksi oleh host jarak jauh. Mungkin NULL.

Nilai kembali

Kemungkinan nilai pengembalian termasuk, tetapi tidak terbatas pada, berikut ini:

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_INVALIDARG
 Satu atau beberapa kondisi berikut ini benar:
  • pszId adalah NULL.
  • Panjang karakter pszId melebihi WSD_MAX_TEXT_LENGTH (8192).
  • Panjang karakter pszSessionId melebihi WSD_MAX_TEXT_LENGTH (8192).
HRESULT_FROM_WIN32(ERROR_NO_CALLBACK_ACTIVE)
 Tidak ada sink pemberitahuan terdaftar. Untuk melampirkan sink, panggil RegisterNotificationSink.
E_ABORT
 Penerbit belum dimulai. Melampirkan sink pemberitahuan akan memulai penerbit. Untuk melampirkan sink, panggil RegisterNotificationSink.
E_OUTOFMEMORY
 Tidak cukup memori untuk menyelesaikan operasi.

Keterangan

Jika berhasil, Terbitkan akan mengirim pesan WS-Discovery Hello ke subnet lokal dengan informasi yang disediakan.

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 wsddisco.h (termasuk Wsdapi.h)
DLL Wsdapi.dll

Lihat juga

IWSDiscoveryPublisher