Função RxNameCacheActivateEntry (namcache.h)

Artigo
02/07/2025

RxNameCacheActivateEntry usa uma entrada de cache de nome e atualiza o tempo de expiração e o contexto de minidiretório de rede. Em seguida, ele coloca a entrada do cache de nomes na lista ativa.

Sintaxe

void RxNameCacheActivateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PNAME_CACHE         NameCache,
  [in] IN ULONG               LifeTime,
  [in] IN ULONG               MRxContext
);

Parâmetros

[in] NameCacheCtl

Um ponteiro para a estrutura NAME_CACHE_CONTROL na qual ativar a entrada.

[in] NameCache

Um ponteiro para a estrutura NAME_CACHE a ser ativada.

[in] LifeTime

Um valor que indica o tempo de vida válido em segundos da entrada de cache. Um valor de 0 significa deixar o valor atual inalterado. Um valor de 0 é usado para reativações após uma correspondência em que você deseja que o tempo de vida original seja preservado.

[in] MRxContext

Um valor de contexto fornecido pelo minidiretório de rede para verificação de igualdade ao fazer uma verificação de entrada válida. Um MRxContext valor de 0 significa deixar o valor atual inalterado. Um valor de 0 é usado para reativações após uma correspondência em que você deseja que o MRxContext original preservado.

Valor de retorno

Nenhum

Observações

A rotina de RxNameCacheActivateEntry normalmente é chamada depois que um minidiretório de rede chama RxNameCacheCreateEntry para alocar e inicializar uma estrutura de 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 nomes, como de Tempo de Vida (em segundos) e MRxContext e, em seguida, coloque a entrada na lista ativa do cache de nomes chamando RxNameCacheActivateEntry.

A rotina RxNameCacheActivateEntry pressupõe que a entrada de cache de nomes não está na lista gratuita ou ativa.