Funzione RxNameCacheFetchEntry (namcache.h)

Articolo
02/26/2024

RxNameCacheFetchEntry cerca una corrispondenza con una stringa di nome specificata per una voce NAME_CACHE.

Sintassi

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

Parametri

[in] NameCacheCtl

Puntatore alla struttura NAME_CACHE_CONTROL da analizzare.

[in] Name

Puntatore alla stringa Unicode contenente il nome da trovare.

Valore restituito

RxNameCacheFetchEntry restituisce un puntatore alla struttura di NAME_CACHE corrispondente se è stata trovata una corrispondenza o NULL se la corrispondenza non è riuscita.

Commenti

RxNameCacheFetchEntry cerca una corrispondenza nell'elenco attivo della cache dei nomi per il parametro Name specificato. Se viene trovato il nome, la voce viene rimossa dall'elenco attivo della cache dei nomi e viene restituito un puntatore alla struttura NAME_CACHE. In caso contrario, viene restituito NULL .

La voce NAME_CACHE viene rimossa dall'elenco attivo per evitare possibili problemi con un altro thread che sta tentando di aggiornare la stessa voce o osservando che è scaduta e inserirla nell'elenco gratuito. È possibile ottenere più voci con lo stesso nome da thread diversi, ma alla fine scadranno.

Se viene trovata una voce di NAME_CACHE corrispondente, non viene eseguita alcuna verifica per la scadenza. Il chiamante deve verificare la scadenza perché potrebbe voler eseguire un'azione speciale.

Come effetto da parte quando viene analizzato l'elenco attivo della cache dei nomi, tutte le voci non corrispondenti scadute vengono inserite nell'elenco gratuito. Il blocco della cache dei nomi viene acquisito per proteggere questa operazione.