PrjClearNegativePathCache 函式 （projectedfslib.h）

清除虛擬化執行個體的負路徑快取 （如果它處於作用中狀態）。

語法

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

參數

[in] namespaceVirtualizationContext

虛擬化執行個體的不透明控制碼。

[out, optional] totalEntryNumber

變數的選擇性指標，該變數接收清除快取之前快取中的路徑數目。

返回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果負路徑快取處於作用中狀態，則如果提供者從其 PRJ_GET_PLACEHOLDER_INFO_CB 回呼傳回 HRESULT_FROM_WIN32 （ERROR_FILE_NOT_FOUND） 來指出檔案路徑不存在，ProjFS 會失敗開啟該路徑的後續開啟，而不會再次呼叫 PRJ_GET_PLACEHOLDER_INFO_CB 回呼。 這有助於改善虛擬化實例的效能，這些實例託管工作負載經常透過嘗試開啟檔案來探測檔案的存在。

若要繼續接收提供者指出不存在之路徑的 PRJ_GET_PLACEHOLDER_INFO_CB 回呼，提供者必須呼叫此常式。

需求