Fungsi RtmInsertInRouteList (rtmv2.h)

  • Artikel

Fungsi RtmInsertInRouteList menyisipkan kumpulan rute yang ditentukan ke dalam daftar rute klien. Jika rute sudah ada di daftar lain, rute dihapus dari daftar lama dan dimasukkan ke dalam yang baru.

Sintaks

DWORD RtmInsertInRouteList(
  [in] RTM_ENTITY_HANDLE     RtmRegHandle,
  [in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [in] UINT                  NumRoutes,
  [in] PRTM_ROUTE_HANDLE     RouteHandles
);

Parameter

[in] RtmRegHandle

Tangani ke klien yang diperoleh dari panggilan sebelumnya ke RtmRegisterEntity.

[in] RouteListHandle

Tangani ke daftar rute yang akan ditambahkan rutenya. Tentukan NULL untuk menghapus rute yang ditentukan dari daftar lamanya.

[in] NumRoutes

Menentukan jumlah rute di RouteHandles.

[in] RouteHandles

Penunjuk ke array handel rute untuk berpindah dari daftar lama ke daftar baru.

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_HANDLE
 Handel tidak valid.

Keterangan

Ketika rute tidak lagi diperlukan, lepaskan dengan memanggil RtmReleaseRoutes.

Untuk kode sampel menggunakan fungsi ini, lihat Menggunakan Daftar Rute Client-Specific.

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

Lihat juga

RtmCreateRouteList

RtmDeleteRouteList