Share via

Função FindOrCreateNameCache (filehc.h)

  • Artigo

Localiza ou cria um cache de nomes.

Sintaxe

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

Parâmetros

[in] lpstrName

O nome do cache de nomes a ser criado. Esse parâmetro diferencia maiúsculas de minúsculas e não deve ser definido como NULL.

[in] pfnKeyCompare

Um ponteiro para uma função fornecida por um cliente para comparar chaves. Esse parâmetro não pode ser NULL.

[in] pfnKeyHash

Um ponteiro para uma função fornecida pelos clientes para calcular um valor de hash em chaves.

Nota O cache fornece uma função de hash somente se o usuário não o fizer. No entanto, a função de hash fornecida internamente é melhor apenas para itens que parecem ser cadeias de caracteres regulares.
 

[in] pfnKeyDestroy

Um ponteiro para a função CACHE_DESTROY_CALLBACK . Este parâmetro pode ser NULL.

[in] pfnDataDestroy

Um ponteiro para a função CACHE_DESTROY_CALLBACK . Este parâmetro pode ser NULL.

Valor retornado

Retorna uma estrutura NAME_CACHE_CONTEXT que representa o cache de nomes.

Comentários

Os caches de nomes são contados por referência. Se essa função for chamada duas vezes com o mesmo nome, uma referência será adicionada a um cache de nomes existente.

A estrutura NAME_CACHE_CONTEXT não contém campos úteis para um cliente, mas deve ser passada de volta para todas as funções de cache de nome.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho filehc.h
Biblioteca Fcachdll.lib
DLL Fcachdll.dll

Confira também

CACHE_DESTROY_CALLBACK

NAME_CACHE_CONTEXT