Partilhar via


Função PrjClearNegativePathCache (projectedfslib.h)

Limpa o cache de caminho negativo da instância de virtualização, se ele estiver ativo.

Sintaxe

HRESULT PrjClearNegativePathCache(
  [in]            PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [out, optional] UINT32                               *totalEntryNumber
);

Parâmetros

[in] namespaceVirtualizationContext

Identificador opaco para a instância de virtualização.

[out, optional] totalEntryNumber

Ponteiro opcional para uma variável que recebe o número de caminhos que estavam no cache antes de ser limpo.

Valor de retorno

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Observações

Se o cache de caminho negativo estiver ativo, se o provedor indicar que um caminho de arquivo não existe retornando HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) de seu retorno de chamada PRJ_GET_PLACEHOLDER_INFO_CB , o ProjFS falhará nas aberturas subsequentes desse caminho sem chamar o retorno de chamada PRJ_GET_PLACEHOLDER_INFO_CB novamente. Isso ajuda a melhorar o desempenho de instâncias de virtualização que hospedam cargas de trabalho que frequentemente investigam a presença de um arquivo tentando abri-lo.

Para retomar o recebimento do retorno de chamada PRJ_GET_PLACEHOLDER_INFO_CB para caminhos que o provedor indicou que não existem, o provedor deve chamar essa rotina.

Requirements

Requirement Value
Cliente mínimo suportado Windows 10, versão 1809 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header projectedfslib.h
Library ProjectedFSLib.lib