Funzione RxNameCacheCreateEntry (namcache.h)

Articolo
05/23/2024

RxNameCacheCreateEntry alloca e inizializza una struttura NAME_CACHE con la stringa del nome specificata.

Sintassi

PNAME_CACHE RxNameCacheCreateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name,
  [in] IN BOOLEAN             CaseInsensitive
);

Parametri

[in] NameCacheCtl

Puntatore alla struttura NAME_CACHE_CONTROL da cui allocare la voce.

[in] Name

Puntatore alla stringa del nome Unicode con cui inizializzare la voce della cache dei nomi.

[in] CaseInsensitive

Valore booleano che indica se è necessario utilizzare confronti senza distinzione tra maiuscole e minuscole durante il confronto del parametro Name .

Valore restituito

RxNameCacheCreateEntry restituisce un puntatore alla struttura NAME_CACHE appena allocata in caso di esito positivo o un puntatore NULL se l'allocazione non riesce.

Commenti

Un mini-redirector di rete chiama RxNameCacheCreateEntry per allocare e inizializzare una struttura NAME_CACHE con la stringa del nome specificata. È previsto che il chiamante inizializzi gli eventuali elementi mini-redirector di rete aggiuntivi del contesto della cache dei nomi, imposti la durata (in secondi) e il membro Context della struttura NAME_CACHE e quindi inserisca la voce nell'elenco attivo della cache dei nomi chiamando RxNameCacheActivateEntry.

RxNameCacheCreateEntry tenterà innanzitutto di riutilizzare una voce NAME_CACHE nell'elenco gratuito, se disponibile, prima di allocare una nuova voce di NAME_CACHE.