Funzione PrjClearNegativePathCache (projectedfslib.h)

Elimina la cache del percorso negativo dell'istanza di virtualizzazione, se attiva.

Sintassi

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

Parametri

[in] namespaceVirtualizationContext

Handle opaco per l'istanza di virtualizzazione.

[out, optional] totalEntryNumber

Puntatore facoltativo a una variabile che riceve il numero di percorsi presenti nella cache prima dell'eliminazione.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se la cache del percorso negativo è attiva, se il provider indica che un percorso di file non esiste restituendo HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) dal callback PRJ_GET_PLACEHOLDER_INFO_CB , ProjFS non riuscirà ad aprire successivamente tale percorso senza chiamare di nuovo il callback PRJ_GET_PLACEHOLDER_INFO_CB . Ciò consente di migliorare le prestazioni delle istanze di virtualizzazione che ospitano carichi di lavoro che spesso verificano la presenza di un file provando ad aprirlo.

Per riprendere la ricezione del callback PRJ_GET_PLACEHOLDER_INFO_CB per i percorsi indicati dal provider non esistono, il provider deve chiamare questa routine.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1809 [solo app desktop]
Server minimo supportato Windows Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione projectedfslib.h