Fungsi RtmGetEnumDests (rtmv2.h)

Artikel
08/25/2023

Fungsi RtmGetEnumDests mengambil set tujuan berikutnya dalam enumerasi yang ditentukan.

Sintaks

DWORD RtmGetEnumDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_ENUM_HANDLE   EnumHandle,
  [in, out] PUINT             NumDests,
  [out]     PRTM_DEST_INFO    DestInfos
);

Parameter

[in] RtmRegHandle

Tangani ke klien yang diperoleh dari panggilan sebelumnya ke RtmRegisterEntity.

[in] EnumHandle

Menangani enumerasi tujuan.

[in, out] NumDests

Pada input, NumDests adalah penunjuk ke nilai UINT yang menentukan jumlah maksimum tujuan yang dapat diterima oleh DestInfos. Pada output, NumDests menerima jumlah tujuan aktual yang diterima oleh DestInfos.

[out] DestInfos

Pada input, DestInfos adalah penunjuk ke struktur RTM_DEST_INFO .

Pada output, DestInfos menerima array handel ke tujuan.

Menampilkan nilai

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	Nilai yang diarahkan oleh NumRoutes lebih besar dari jumlah maksimum rute yang diizinkan untuk diambil klien dengan satu panggilan. Periksa RTM_REGN_PROFILE jumlah maksimum tujuan yang diizinkan untuk diambil klien dengan satu panggilan.
ERROR_NO_MORE_ITEMS	Tidak ada lagi tujuan untuk dijumlahkan.

Keterangan

Struktur yang ditunjukkan oleh DestInfos adalah struktur berukuran variabel. Jika klien menentukan lebih dari satu tampilan dengan TargetViews, ukuran DestInfos meningkat untuk setiap tampilan. Gunakan makro RTM_SIZE_OF_DEST_INFO untuk menentukan seberapa besar struktur DestInfos untuk dialokasikan sebelum memanggil fungsi ini. Gunakan nilai yang ditentukan untuk TargetViews sebagai parameter untuk RTM_SIZE_OF_DEST_INFO.

Ketika tujuan tidak lagi diperlukan, lepaskan dengan memanggil RtmReleaseDests.

Untuk kode sampel menggunakan fungsi ini, lihat Menghitung Semua Tujuan.

Persyaratan


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

Lihat juga

Bagikan melalui