PrjClearNegativePathCache-Funktion (projectedfslib.h)

Artikel
03/01/2024

Löscht den Negativen Pfadcache der Virtualisierung instance, wenn er aktiv ist.

Syntax

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

Parameter

[in] namespaceVirtualizationContext

Undurchsichtiges Handle für die Virtualisierung instance.

[out, optional] totalEntryNumber

Optionaler Zeiger auf eine Variable, die die Anzahl der Pfade empfängt, die sich im Cache befanden, bevor er gelöscht wurde.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der negative Pfadcache aktiv ist, gibt der Anbieter an, dass ein Dateipfad nicht vorhanden ist, indem er HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) aus seinem PRJ_GET_PLACEHOLDER_INFO_CB Rückruf zurückgibt, schlägt ProjFS bei nachfolgenden Öffnen dieses Pfads fehl, ohne den PRJ_GET_PLACEHOLDER_INFO_CB Rückruf erneut aufzurufen. Dies trägt zur Verbesserung der Leistung von Virtualisierungsinstanzen bei, die Workloads hosten, die häufig das Vorhandensein einer Datei überprüfen, indem Sie versuchen, sie zu öffnen.

Um den Empfang des PRJ_GET_PLACEHOLDER_INFO_CB Rückrufs für Pfade fortzusetzen, die der Anbieter angegeben hat, dass sie nicht vorhanden sind, muss der Anbieter diese Routine aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	projectedfslib.h

Freigeben über