Metode IWSDiscoveryPublisher::UnPublish (wsddisco.h)

Artikel
08/28/2023

Mengumumkan keberangkatan host jaringan dengan mengirim pesan Bye .

Sintaks

HRESULT UnPublish(
  [in]           LPCWSTR              pszId,
  [in]           ULONGLONG            ullInstanceId,
  [in]           ULONGLONG            ullMessageNumber,
  [in, optional] LPCWSTR              pszSessionId,
  [in, optional] const WSDXML_ELEMENT *pAny
);

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] 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] pAny

Penunjuk ke struktur WSDXML_ELEMENT yang berisi elemen XML yang akan disisipkan di bagian "ANY" dari isi pesan.

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 pszId melebihi WSD_MAX_TEXT_LENGTH (8192). Panjang pszSessionId melebihi WSD_MAX_TEXT_LENGTH (8192).
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, UnPublish akan mengirim pesan WS-Discovery Bye ke subnet lokal dengan informasi yang disediakan.

Persyaratan


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

Bagikan melalui