Fungsi RtmGetChangedDests (rtmv2.h)

Artikel
03/01/2024

Fungsi RtmGetChangedDests mengembalikan sekumpulan tujuan dengan informasi yang diubah.

Sintaks

DWORD RtmGetChangedDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_NOTIFY_HANDLE NotifyHandle,
  [in, out] PUINT             NumDests,
  [out]     PRTM_DEST_INFO    ChangedDests
);

Parameter

[in] RtmRegHandle

Tangani ke klien yang diperoleh dari panggilan sebelumnya ke RtmRegisterEntity.

[in] NotifyHandle

Tangani ke pemberitahuan perubahan yang diperoleh dari panggilan sebelumnya ke RtmRegisterForChangeNotification.

[in, out] NumDests

Pada input, NumDests adalah penunjuk ke nilai UINT yang menentukan jumlah maksimum tujuan yang dapat diterima oleh ChangedDests.

Pada output, NumDests menerima jumlah tujuan aktual yang diterima oleh ChangedDests.

[out] ChangedDests

Pada input, ChangedDests adalah penunjuk ke array struktur RTM_DEST_INFO .

Pada output, ChangedDests diisi dengan informasi tujuan yang diubah.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Parameter berisi informasi yang salah.
ERROR_NO_MORE_ITEMS	Tidak ada lagi tujuan yang diubah untuk diambil.

Keterangan

Klien diberi tahu tentang perubahan oleh RTM_EVENT_CALLBACK. RTM_EVENT_CALLBACK hanya digunakan untuk memberi tahu klien, tidak memberikan perubahan. Setelah pemberitahuan perubahan diterima, klien harus memanggil RtmGetChangedDests berulang kali untuk mengambil semua perubahan.

Jika dua atau lebih perubahan pada tujuan yang sama telah terjadi sejak pemberitahuan, hanya perubahan terbaru yang dikembalikan.

Ketika klien tidak lagi memerlukan handel di ChangedDests, klien harus menggunakan RtmReleaseChangedDests untuk merilis handel.

Untuk kode sampel menggunakan fungsi ini, lihat Menggunakan Panggilan Balik Pemberitahuan Peristiwa.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	rtmv2.h
Pustaka	Rtm.lib
DLL	Rtm.dll