PrjGetOnDiskFileState 函式 (projectedfslib.h)

取得檔案或目錄的磁碟上檔案狀態。

語法

HRESULT PrjGetOnDiskFileState(
  [in]  PCWSTR         destinationFileName,
  [out] PRJ_FILE_STATE *fileState
);

[in] destinationFileName

以 Null 結束的 Unicode 字串，指定要查詢其狀態之檔案的完整路徑。

[out] fileState

這是描述檔案狀態的一或多個PRJ_FILE_STATE值的組合。

HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND) 表示 destinationFileName 不存在。 HRESULT_FROM_WIN32 (ERROR_PATH_NOT_FOUND) 表示 destinationFileName 路徑的中繼元件不存在。

這個例程會告訴呼叫者 ProjFS 快取狀態是指定的檔案或目錄。例如，呼叫端可以使用這個例程來判斷指定的專案是否為佔位元或完整檔案。

如果在其中一個虛擬化實例內的檔案或目錄上使用這個例程，執行中的提供者應該小心，因為它可能會導致在提供者中叫用回呼。視提供者的設計而定，這可能會導致死結。