Fonction FindOrCreateNameCache (filehc.h)

Article
08/23/2023

Recherche ou crée un cache de noms.

Syntaxe

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
);

Paramètres

[in] lpstrName

Nom du cache de noms à créer. Ce paramètre respecte la casse et ne doit pas être défini sur NULL.

[in] pfnKeyCompare

Pointeur vers une fonction fournie par un client pour comparer des clés. Ce paramètre ne peut pas être NULL.

[in] pfnKeyHash

Pointeur vers une fonction fournie par les clients pour calculer une valeur de hachage sur les clés.

Note Le cache fournit une fonction de hachage uniquement si l’utilisateur ne le fait pas. Toutefois, la fonction de hachage fournie en interne est préférable uniquement pour les éléments qui semblent être des chaînes régulières.

[in] pfnKeyDestroy

Pointeur vers la fonction CACHE_DESTROY_CALLBACK . Ce paramètre peut être NULL.

[in] pfnDataDestroy

Pointeur vers la fonction CACHE_DESTROY_CALLBACK . Ce paramètre peut être NULL.

Valeur retournée

Retourne une structure NAME_CACHE_CONTEXT qui représente le cache de noms.

Notes

Les caches de noms sont comptés pour les références. Si cette fonction est appelée deux fois avec le même nom, une référence est ajoutée à un cache de noms existant.

La structure NAME_CACHE_CONTEXT ne contient pas de champs utiles à un client, mais elle doit être renvoyée à toutes les fonctions de cache de noms.

Spécifications


Plateforme cible	Windows
En-tête	filehc.h
Bibliothèque	Fcachdll.lib
DLL	Fcachdll.dll

Voir aussi

CACHE_DESTROY_CALLBACK

NAME_CACHE_CONTEXT

Partager via