RxNameCacheActivateEntry-Funktion (namcache.h)

Artikel
02/26/2024

RxNameCacheActivateEntry nimmt einen Namenscacheeintrag an und aktualisiert die Ablaufzeit und den Netzwerkminiumleitungskontext. Anschließend wird der Namenscacheeintrag in die aktive Liste aufgenommen.

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 des Cacheeintrags in Sekunden angibt. Ein Wert von 0 bedeutet, dass der aktuelle Wert unverändert bleibt. Der Wert 0 wird für Reaktivierungen nach einer Übereinstimmung verwendet, bei der die ursprüngliche Lebensdauer beibehalten werden soll.

[in] MRxContext

Ein Wert des Kontexts, der vom Netzwerk-Miniumleitungsor für die Gleichheitsprüfung bei einer gültigen Eintragsprüfung bereitgestellt wird. Ein MRxContext-Wert von 0 bedeutet, dass der aktuelle Wert unverändert bleibt. Der Wert 0 wird für Reaktivierungen nach einer Übereinstimmung verwendet, bei der der ursprüngliche MRxContext beibehalten werden soll.

Rückgabewert

Keine

Bemerkungen

Die RxNameCacheActivateEntry-Routine wird normalerweise aufgerufen, nachdem ein Netzwerk-Mini-Redirector RxNameCacheCreateEntry aufgerufen hat, 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 die Liste des aktiven Namencaches einzufügen, indem RxNameCacheActivateEntry aufgerufen wird.

Bei der RxNameCacheActivateEntry-Routine wird davon ausgegangen, dass der Namenscacheeintrag weder in der freien noch in der aktiven Liste enthalten ist.