Funzione RxNameCacheCreateEntry (namcache.h)

Articolo
08/07/2023

RxNameCacheCreateEntry alloca e inizializza una struttura NAME_CACHE con la stringa di 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 nome Unicode con cui inizializzare la voce della cache dei nomi.

[in] CaseInsensitive

Valore booleano che indica se devono essere usati confronti senza distinzione tra maiuscole e minuscole durante il confronto del parametro Name .

Valore restituito

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

Commenti

Un mini-reindirizzamento di rete chiama RxNameCacheCreateEntry per allocare e inizializzare una struttura NAME_CACHE con la stringa di nome specificata. Si prevede che il chiamante inizializzi eventuali elementi mini-reindirizzamento di rete aggiuntivi del contesto della cache dei nomi, imposta 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à di riutilizzare una voce NAME_CACHE nell'elenco gratuito, se disponibile, prima di allocare una nuova voce NAME_CACHE.