Funzione FindOrCreateNameCache (filehc.h)

  • Articolo

Trova o crea una cache dei nomi.

Sintassi

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

Parametri

[in] lpstrName

Nome della cache dei nomi da creare. Questo parametro fa distinzione tra maiuscole e minuscole e non deve essere impostato su NULL.

[in] pfnKeyCompare

Puntatore a una funzione fornita da un client per confrontare le chiavi. Questo parametro non può essere NULL.

[in] pfnKeyHash

Puntatore a una funzione fornita dai client per calcolare un valore hash sulle chiavi.

Nota La cache fornisce una funzione hash solo se l'utente non lo fa. Tuttavia, la funzione hash fornita internamente è ottimale solo per gli elementi che sembrano essere stringhe regolari.
 

[in] pfnKeyDestroy

Puntatore alla funzione CACHE_DESTROY_CALLBACK . Questo parametro può essere NULL.

[in] pfnDataDestroy

Puntatore alla funzione CACHE_DESTROY_CALLBACK . Questo parametro può essere NULL.

Valore restituito

Restituisce una struttura NAME_CACHE_CONTEXT che rappresenta la cache dei nomi.

Commenti

Le cache dei nomi vengono conteggiate. Se questa funzione viene chiamata due volte con lo stesso nome, viene aggiunto un riferimento a una cache dei nomi esistente.

La struttura NAME_CACHE_CONTEXT non contiene campi utili per un client, ma deve essere passato di nuovo in tutte le funzioni della cache dei nomi.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione filehc.h
Libreria Fcachdll.lib
DLL Fcachdll.dll

Vedi anche

CACHE_DESTROY_CALLBACK

NAME_CACHE_CONTEXT