Função RxNameCacheCreateEntry (namcache.h)

Artigo
02/26/2024

RxNameCacheCreateEntry aloca e inicializa uma estrutura NAME_CACHE com a cadeia de caracteres de nome fornecida.

Sintaxe

PNAME_CACHE RxNameCacheCreateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name,
  [in] IN BOOLEAN             CaseInsensitive
);

Parâmetros

[in] NameCacheCtl

Um ponteiro para a estrutura NAME_CACHE_CONTROL da qual alocar a entrada.

[in] Name

Um ponteiro para a cadeia de caracteres de nome Unicode com a qual inicializar a entrada de cache de nome.

[in] CaseInsensitive

Um valor booliano que indica se comparações que não diferenciam maiúsculas de minúsculas devem ser usadas ao comparar o parâmetro Name .

Retornar valor

RxNameCacheCreateEntry retorna um ponteiro para a estrutura de NAME_CACHE recém-alocada com êxito ou um ponteiro NULL se a alocação falhar.

Comentários

Um minidiretório de rede chama RxNameCacheCreateEntry para alocar e inicializar uma estrutura NAME_CACHE com a cadeia de caracteres de nome fornecida. Espera-se que o chamador inicialize todos os elementos adicionais de minidiretório de rede do contexto de cache de nome, defina o tempo de vida (em segundos) e o membro Context da estrutura NAME_CACHE e coloque a entrada na lista ativa do cache de nomes chamando RxNameCacheActivateEntry.

RxNameCacheCreateEntry primeiro tentará reutilizar uma entrada NAME_CACHE na lista gratuita, se houver uma disponível, antes de alocar uma nova entrada de NAME_CACHE.