Fonction RxNameCacheCreateEntry (namcache.h)

Article
02/29/2024

RxNameCacheCreateEntry alloue et initialise une structure NAME_CACHE avec la chaîne de nom donnée.

Syntaxe

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

Paramètres

[in] NameCacheCtl

Pointeur vers la structure NAME_CACHE_CONTROL à partir de laquelle allouer l’entrée.

[in] Name

Pointeur vers la chaîne de nom Unicode avec laquelle initialiser l’entrée du cache de noms.

[in] CaseInsensitive

Valeur booléenne qui indique si des comparaisons sans respect de la casse doivent être utilisées lors de la comparaison du paramètre Name .

Valeur retournée

RxNameCacheCreateEntry retourne un pointeur vers la structure NAME_CACHE nouvellement allouée en cas de réussite ou un pointeur NULL si l’allocation échoue.

Remarques

Un mini-redirecteur réseau appelle RxNameCacheCreateEntry pour allouer et initialiser une structure NAME_CACHE avec la chaîne de nom donnée. On s’attend à ce que l’appelant initialise ensuite tous les éléments de mini-redirecteur réseau supplémentaires du contexte de cache de noms, définisse la durée de vie (en secondes) et le membre de contexte de la structure NAME_CACHE, puis place l’entrée sur la liste active du cache de noms en appelant RxNameCacheActivateEntry.

RxNameCacheCreateEntry tente d’abord de réutiliser une entrée NAME_CACHE dans la liste gratuite, le cas échéant, avant d’allouer une nouvelle entrée NAME_CACHE.