Função RxNameCacheActivateEntry (namcache.h)

Artigo
03/01/2024

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 de cache de nome 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 entrada válida marcar. Um valor MRxContext 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 seja preservado.

Retornar valor

Nenhum

Comentários

A rotina RxNameCacheActivateEntry normalmente é chamada depois que 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 quaisquer elementos adicionais de minidiretório de rede do contexto de cache de nome, como Tempo de Vida (em segundos) e MRxContext, e 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 esteja na lista gratuita ou ativa.