Funzione RxNameCacheCreateEntry (namcache.h)

Articolo
02/07/2025

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 usare 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 di un puntatore NULL se l'allocazione ha esito negativo.

Osservazioni

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 quindi eventuali elementi aggiuntivi del mini-reindirizzamento di rete del contesto della cache dei nomi, imposti la durata (in secondi) e il contesto membro 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 NAME_CACHE.