FindOrCreateNameCache-Funktion (filehc.h)

Sucht oder erstellt einen Namenscache.

Syntax

FILEHC_EXPORT PNAME_CACHE_CONTEXT FindOrCreateNameCache(
  [in] LPSTR                  lpstrName,
  [in] CACHE_KEY_COMPARE      pfnKeyCompare,
  [in] CACHE_KEY_HASH         pfnKeyHash,
  [in] CACHE_DESTROY_CALLBACK pfnKeyDestroy,
  [in] CACHE_DESTROY_CALLBACK pfnDataDestroy
);

Parameter

[in] lpstrName

Der Name des zu erstellenden Namenscaches. Bei diesem Parameter wird die Groß-/Kleinschreibung beachtet und darf nicht auf NULL festgelegt werden.

[in] pfnKeyCompare

Ein Zeiger auf eine Funktion, die von einem Client zum Vergleichen von Schlüsseln bereitgestellt wird. Dieser Parameter darf nicht NULL sein.

[in] pfnKeyHash

Ein Zeiger auf eine Funktion, die von Clients bereitgestellt wird, um einen Hashwert für Schlüssel zu berechnen.

Hinweis Der Cache stellt nur dann eine Hashfunktion bereit, wenn der Benutzer dies nicht tut. Die intern bereitgestellte Hashfunktion eignet sich jedoch nur für Elemente, bei denen es sich um reguläre Zeichenfolgen handelt.

 

[in] pfnKeyDestroy

Ein Zeiger auf die CACHE_DESTROY_CALLBACK-Funktion . Dieser Parameter kann NULL sein.

[in] pfnDataDestroy

Ein Zeiger auf die CACHE_DESTROY_CALLBACK-Funktion . Dieser Parameter kann NULL sein.

Rückgabewert

Gibt eine NAME_CACHE_CONTEXT-Struktur zurück, die den Namenscache darstellt.

Hinweise

Namenscaches werden referenziert. Wenn diese Funktion zweimal mit demselben Namen aufgerufen wird, wird einem vorhandenen Namenscache ein Verweis hinzugefügt.

Die NAME_CACHE_CONTEXT-Struktur enthält keine Felder, die für einen Client nützlich sind, aber sie muss an alle Namenscachefunktionen zurückgegeben werden.

Anforderungen

Zielplattform	Windows
Kopfzeile	filehc.h
Bibliothek	Fcachdll.lib
DLL	Fcachdll.dll

Weitere Informationen

CACHE_DESTROY_CALLBACK

NAME_CACHE_CONTEXT