PrjDeleteFile 函式 （projectedfslib.h）

可讓提供者刪除已快取在本機檔案系統上的專案。

語法

HRESULT PrjDeleteFile(
  [in]            PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in]            PCWSTR                               destinationFileName,
  [in, optional]  PRJ_UPDATE_TYPES                     updateFlags,
  [out, optional] PRJ_UPDATE_FAILURE_CAUSES            *failureReason
);

參數

[in] namespaceVirtualizationContext

虛擬化實例的不透明控制碼。

[in] destinationFileName

以 Null 結尾的 Unicode 字串，指定相對於虛擬化根目錄到要刪除的檔案或目錄的路徑。

[in, optional] updateFlags

應該允許控制刪除作業的旗標，以指定檔案的狀態。

[out, optional] failureReason

選擇性指標，用於接收描述刪除失敗原因的程式碼。

返回值

如果傳回 HRESULT_FROM_WIN32 （ERROR_FILE_SYSTEM_VIRTUALIZATION_INVALID_OPERATION） 錯誤，則更新會因為項目的狀態和 updateFlags 的值而失敗。 failureReason，如果指定，則會描述失敗的原因。

備註

如果專案仍在提供者的支援存放區中，則從本機檔案系統刪除它會將其變更為虛擬專案。

無法在虛擬檔案/目錄上呼叫此常式。

如果要刪除的檔案/目錄處於「預留位置」以外的任何狀態，提供者必須在 updateFlags 參數中指定適當的 PRJ_UPDATE_TYPES 值組合。 這有助於防止資料意外遺失。

需求