Menggunakan Daftar Rute Client-Specific

Prosedur berikut menguraikan langkah-langkah untuk menggunakan daftar rute khusus klien. Kode sampel yang mengikuti menunjukkan cara menerapkan prosedur.

Untuk menggunakan fitur ini, klien harus mengambil langkah-langkah berikut

1. Panggil RtmCreateRouteList untuk mendapatkan handel dari manajer tabel perutean.
2. Hubungi RtmInsertInRouteList setiap kali klien harus menambahkan rute ke daftar ini.
3. Ketika klien tidak lagi memerlukan daftar, klien harus memanggil RtmDeleteRouteList untuk menghapus daftar.

Jika klien harus menghitung rute dalam daftar, klien harus mengambil langkah-langkah berikut

1. Panggil RtmCreateRouteListEnum untuk mendapatkan handel enumerasi dari manajer tabel perutean.
2. Panggil RtmGetListEnumRoutes untuk mendapatkan handel ke rute dalam daftar.
3. Panggil RtmReleaseRoutes untuk melepaskan handel saat tidak lagi diperlukan.

Kode sampel berikut menunjukkan cara membuat dan menggunakan daftar rute khusus klien.

HANDLE RouteListHandle1;
HANDLE RouteListHandle2;

// Create two entity-specific lists to add routes to

Status = RtmCreateRouteList(RtmRegHandle,
                            &RouteListHandle1);
// Check Status
//...

Status = RtmCreateRouteList(RtmRegHandle,
                            &RouteListHandle2);
// Check Status
//...

// Assume you have added a bunch of routes
// by calling RtmAddRouteToDest many times
// with 'RouteListHandle1' specified similar to
// Status = RtmAddRouteToDest(RtmRegHandle,
//                            ...
//                            RouteListHandle1,
//                            ...
//                            &ChangeFlags);

// Enumerate routes in RouteListHandle1 list

// Create an enumeration on the route list

Status = RtmCreateRouteListEnum(RtmRegHandle,
                                RouteListHandle1,
                                &EnumHandle);

if (Status == NO_ERROR)
{
        // Allocate space on the top of the stack
        
    MaxHandles = RegnProfile.MaxHandlesInEnum;

    RouteHandles = _alloca(MaxHandles * sizeof(HANDLE));

    // Note how the termination condition is different
    // from other enumerations - the call to the function
    // RtmGetListEnumRoutes always returns NO_ERROR
    // Quit when you get fewer handles than requested
    
    do
    {
                // Get next set of routes from the list enumeration
        
        NumHandles = MaxHandles;

        Status = RtmGetListEnumRoutes(RtmRegHandle,
                                      EnumHandle,
                                      &NumHandles,
                                      RouteHandles);

        for (i = 0; i < NumHandles; i++)
        {
            Print("Route Handle %5lu: %p\n", i, RouteHandles[i]);
        }

        // Move all these routes to another route list
        // They are automatically removed from the old one
        
        Status = RtmInsertInRouteList(RtmRegHandle,
                                      RouteListHandle2,
                                      NumHandles,
                                      RouteHandles);
        // Check Status...
        
                // Release the routes that have been enumerated
        
        RtmReleaseRoutes(RtmRegHandle, NumHandles, RouteHandles);
    }
    while (NumHandles == MaxHandles);

    RtmDeleteEnumHandle(RtmRegHandle, EnumHandle);
}

// Destroy all the entity-specific route lists 
// after removing all routes from these lists;
// the routes themselves are not deleted

Status = RtmDeleteRouteList(RtmRegHandle, RouteListHandle1);
ASSERT(Status == NO_ERROR);


Status = RtmDeleteRouteList(RtmRegHandle, RouteListHandle2);
ASSERT(Status == NO_ERROR);