Fonction RxNameCacheActivateEntry (namcache.h)

Article
03/01/2024

RxNameCacheActivateEntry prend une entrée de cache de noms et met à jour l’heure d’expiration et le contexte du mini-redirecteur réseau. Il place ensuite l’entrée du cache de noms sur 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 du cache. La valeur 0 signifie laisser la valeur actuelle inchangée. La valeur 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 l’établissement d’une entrée valide case activée. Une valeur MRxContext de 0 signifie laisser la valeur actuelle inchangée. La valeur 0 est utilisée pour les réactivations après une correspondance où vous souhaitez conserver le MRxContext d’origine.

Valeur de retour

None

Remarques

La routine RxNameCacheActivateEntry est normalement appelée après qu’un mini-redirecteur réseau a appelé 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, tels que Lifetime (en secondes) et MRxContext, puis place l’entrée sur la liste active du cache de noms en appelant RxNameCacheActivateEntry.

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