RxNameCacheActivateEntry, fonction (namcache.h)

Article
02/07/2025

RxNameCacheActivateEntry prend une entrée de cache de noms et met à jour le temps d’expiration et le contexte de mini-redirecteur réseau. Il place ensuite l’entrée du cache de noms dans la liste active.

Syntaxe

void RxNameCacheActivateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PNAME_CACHE         NameCache,
  [in] IN ULONG               LifeTime,
  [in] IN ULONG               MRxContext
);

Paramètres

[in] NameCacheCtl

Pointeur vers la structure NAME_CACHE_CONTROL sur laquelle activer l’entrée.

[in] NameCache

Pointeur vers la structure NAME_CACHE à activer.

[in] LifeTime

Valeur qui indique la durée de vie valide en secondes de l’entrée de cache. La valeur 0 signifie que la valeur actuelle n’est pas modifiée. Une valeur de 0 est utilisée pour les réactivations après une correspondance où vous souhaitez conserver la durée de vie d’origine.

[in] MRxContext

Valeur de contexte fournie par le mini-redirecteur réseau pour la vérification de l’égalité lors de la vérification d’une entrée valide. Un MRxContext valeur de 0 signifie laisser la valeur actuelle inchangée. Une valeur de 0 est utilisée pour les réactivations après une correspondance où vous souhaitez conserver le MRxContext d’origine conservé.

Valeur de retour

Aucun

Remarques

La routine RxNameCacheActivateEntry est normalement appelée après qu’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 de cache de noms, tels que durée de vie (en secondes) et MRxContext, puis placer l’entrée dans la liste active du cache de noms en appelant RxNameCacheActivateEntry.

La routine RxNameCacheActivateEntry suppose que l’entrée du cache de noms n’est pas dans la liste libre ou active.