Fungsi RxNameCacheActivateEntry (namcache.h)

Artikel
02/26/2024

RxNameCacheActivateEntry mengambil entri cache nama dan memperbarui waktu kedaluwarsa dan konteks pengalihan mini jaringan. Kemudian menempatkan entri cache nama pada daftar aktif.

Sintaks

void RxNameCacheActivateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PNAME_CACHE         NameCache,
  [in] IN ULONG               LifeTime,
  [in] IN ULONG               MRxContext
);

Parameter

[in] NameCacheCtl

Penunjuk ke struktur NAME_CACHE_CONTROL untuk mengaktifkan entri.

[in] NameCache

Penunjuk ke struktur NAME_CACHE untuk diaktifkan.

[in] LifeTime

Nilai yang menunjukkan masa pakai yang valid dalam detik entri cache. Nilai 0 berarti membiarkan nilai saat ini tidak berubah. Nilai 0 digunakan untuk aktivasi ulang setelah kecocokan di mana Anda ingin masa pakai asli dipertahankan.

[in] MRxContext

Nilai konteks yang disediakan oleh pengalih mini jaringan untuk pemeriksaan kesetaraan saat melakukan pemeriksaan entri yang valid. Nilai MRxContext 0 berarti membiarkan nilai saat ini tidak berubah. Nilai 0 digunakan untuk aktivasi ulang setelah kecocokan di mana Anda ingin MRxContext asli dipertahankan .

Nilai kembali

Tidak ada

Keterangan

Rutinitas RxNameCacheActivateEntry biasanya dipanggil setelah redirector mini jaringan memanggil RxNameCacheCreateEntry untuk mengalokasikan dan menginisialisasi struktur NAME_CACHE dengan string nama yang diberikan. Diharapkan bahwa pemanggil kemudian akan menginisialisasi elemen pengalih mini jaringan tambahan dari konteks cache nama, seperti Lifetime (dalam detik) dan MRxContext, lalu menempatkan entri pada daftar aktif cache nama dengan memanggil RxNameCacheActivateEntry.

Rutinitas RxNameCacheActivateEntry mengasumsikan bahwa entri cache nama tidak ada di daftar gratis atau aktif.