RxNameCacheCreateEntry-Funktion (namcache.h)

Artikel
02/07/2025

RxNameCacheCreateEntry eine NAME_CACHE Struktur mit der angegebenen Namenszeichenfolge zuordnet und initialisiert.

Syntax

PNAME_CACHE RxNameCacheCreateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name,
  [in] IN BOOLEAN             CaseInsensitive
);

Parameter

[in] NameCacheCtl

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

[in] Name

Ein Zeiger auf die Unicode-Namenszeichenfolge, mit der der Namenscacheeintrag initialisiert werden soll.

[in] CaseInsensitive

Ein boolescher Wert, der angibt, ob beim Vergleichen des parameters Name Parameter die Groß-/Kleinschreibung nicht beachtet werden soll.

Rückgabewert

RxNameCacheCreateEntry-gibt einen Zeiger auf die neu zugeordnete NAME_CACHE Struktur für erfolg oder einen NULL- Zeiger zurück, wenn die Zuordnung fehlschlägt.

Bemerkungen

Ein Netzwerk-Miniumleitung ruft RxNameCacheCreateEntry- auf, 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, die Lebensdauer (in Sekunden) und das Context Member der NAME_CACHE-Struktur festgelegt und dann den Eintrag in der aktiven Liste des Namenscaches platziert, indem RxNameCacheActivateEntryaufgerufen wird.

RxNameCacheCreateEntry versucht zunächst, einen NAME_CACHE Eintrag in der kostenlosen Liste wiederzuverwenden, sofern vorhanden, bevor ein neuer NAME_CACHE Eintrag zugewiesen wird.