RxNameCacheActivateEntry-Funktion (namcache.h)

Artikel
02/07/2025

RxNameCacheActivateEntry nimmt einen Namencacheeintrag und aktualisiert die Ablaufzeit und den Netzwerk-Miniumleitungskontext. Anschließend wird der Namenscacheeintrag in die aktive Liste versetzt.

Syntax

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

Parameter

[in] NameCacheCtl

Ein Zeiger auf die NAME_CACHE_CONTROL Struktur, auf der der Eintrag aktiviert werden soll.

[in] NameCache

Ein Zeiger auf die zu aktivierende NAME_CACHE Struktur.

[in] LifeTime

Ein Wert, der die gültige Lebensdauer in Sekunden des Cacheeintrags angibt. Ein Wert von 0 bedeutet, dass der aktuelle Wert unverändert bleibt. Ein Wert von 0 wird für Reaktivierungen nach einer Übereinstimmung verwendet, in der die ursprüngliche Lebensdauer beibehalten werden soll.

[in] MRxContext

Ein Wert des Kontexts, der vom Netzwerk-Miniumleitungsmodul für die Gleichheitsprüfung beim Erstellen einer gültigen Eintragsprüfung bereitgestellt wird. Ein MRxContext Wert 0 bedeutet, den aktuellen Wert unverändert zu lassen. Ein Wert von 0 wird für Reaktivierungen nach einer Übereinstimmung verwendet, in der das ursprüngliche MRxContext beibehalten werden soll.

Rückgabewert

Nichts

Bemerkungen

Die RxNameCacheActivateEntry Routine wird normalerweise aufgerufen, nachdem ein Netzwerk-Miniumleitungsmodul RxNameCacheCreateEntry aufgerufen wird, um eine NAME_CACHE Struktur mit der angegebenen Namenszeichenfolge zuzuweisen und zu initialisieren. Es wird erwartet, dass der Aufrufer dann alle zusätzlichen Netzwerkminiumleitungselemente des Namenscachekontexts initialisiert, z. B. Lifetime (in Sekunden) und MRxContext-und dann den Eintrag in der aktiven Liste des Namenscaches platzieren, indem RxNameCacheActivateEntryaufgerufen wird.

Die RxNameCacheActivateEntry Routine geht davon aus, dass sich der Namenscacheeintrag nicht in der kostenlosen oder aktiven Liste befindet.