RxNameCacheCreateEntry, fonction (namcache.h)

Article
07/02/2025

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 les comparaisons non sensibles à la casse doivent être utilisées lors de la comparaison du paramètre Name.

Valeur de retour

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

Remarques

Un mini-redirecteur réseau appelle RxNameCacheCreateEntry pour allouer et initialiser une structure NAME_CACHE avec la chaîne de nom donnée. Il est prévu que l’appelant initialise ensuite tous les éléments de mini-redirecteur réseau supplémentaires du contexte du cache de noms, définissez la durée de vie (en secondes) et le membre Context de la structure NAME_CACHE, puis placez l’entrée dans la liste active du cache de noms en appelant RxNameCacheActivateEntry.

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