Função RxNameCacheCreateEntry (namcache.h)
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.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | namcache.h (inclua Namcache.h) |
IRQL | <= APC_LEVEL |