Fungsi RxNameCacheFetchEntry (namcache.h)

Artikel
08/07/2023

RxNameCacheFetchEntry mencari kecocokan dengan string nama tertentu untuk entri NAME_CACHE.

Sintaks

PNAME_CACHE RxNameCacheFetchEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name
);

Parameter

[in] NameCacheCtl

Penunjuk ke struktur NAME_CACHE_CONTROL untuk dipindai.

[in] Name

Penunjuk ke string Unicode yang berisi nama yang cocok.

Nilai kembali

RxNameCacheFetchEntry mengembalikan penunjuk ke struktur NAME_CACHE yang cocok jika kecocokan ditemukan, atau NULL jika kecocokan gagal.

Keterangan

RxNameCacheFetchEntry mencari kecocokan dalam daftar aktif cache nama untuk parameter Nama yang ditentukan. Jika nama ditemukan, entri dihapus dari daftar aktif cache nama dan penunjuk ke struktur NAME_CACHE dikembalikan. Jika tidak, NULL dikembalikan.

Entri NAME_CACHE dihapus dari daftar aktif untuk menghindari kemungkinan masalah dengan utas lain yang mencoba memperbarui entri yang sama, atau mengamati bahwa entri tersebut kedaluwarsa dan memasukkannya ke daftar gratis. Dimungkinkan untuk mendapatkan beberapa entri dengan nama yang sama dengan utas yang berbeda, tetapi akhirnya akan kedaluwarsa.

Jika entri NAME_CACHE yang cocok ditemukan, tidak ada pemeriksaan yang dilakukan untuk kedaluwarsa. Penelepon harus memeriksa kedaluwarsa karena mungkin ingin mengambil beberapa tindakan khusus.

Sebagai efek samping karena daftar aktif cache nama dipindai, entri yang tidak cocok yang telah kedaluwarsa dimasukkan ke daftar gratis. Kunci cache nama diperoleh untuk melindungi operasi ini.