RxNameCacheCreateEntry-Funktion (namcache.h)
RxNameCacheCreateEntry weist eine NAME_CACHE-Struktur mit der angegebenen Namenszeichenfolge zu und initialisiert diese.
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 Vergleich des Parameters Name keine Vergleiche ohne Beachtung der Groß-/Kleinschreibung verwendet werden sollen.
Rückgabewert
RxNameCacheCreateEntry gibt einen Zeiger auf die neu zugewiesene NAME_CACHE-Struktur bei Erfolg oder einen NULL-Zeiger zurück, wenn die Zuordnung fehlschlägt.
Hinweise
Ein Netzwerkminiumleitungsor ruft RxNameCacheCreateEntry auf, um eine NAME_CACHE Struktur mit der angegebenen Namenszeichenfolge zuzuordnen und zu initialisieren. Es wird erwartet, dass der Aufrufer dann alle zusätzlichen Netzwerkminiumleitungselemente des Namenscachekontexts initialisiert, die Lebensdauer (in Sekunden) und das Context-Element der NAME_CACHE-Struktur festgelegt und den Eintrag dann in der Aktiven Namenscacheliste platziert, indem RxNameCacheActivateEntry aufgerufen wird.
RxNameCacheCreateEntry versucht zunächst, einen NAME_CACHE Eintrag in der kostenlosen Liste wiederzuverwenden, sofern verfügbar, bevor ein neuer NAME_CACHE-Eintrag zugewiesen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | namcache.h (include Namcache.h) |
| IRQL | <= APC_LEVEL |