DeleteFileTransactedA 函式 (winbase.h)

[Microsoft 強烈建議開發人員利用替代方式來達成應用程式的需求。 許多針對 TxF 開發的案例，都可以透過更簡單且更容易使用的技巧來達成。 此外，未來版本的 Microsoft Windows 可能無法使用 TxF。 如需詳細資訊，以及 TxF 的替代方案，請參閱 使用交易式 NTFS 的替代方案。

刪除現有的檔案做為交易作業。

語法

BOOL DeleteFileTransactedA(
  [in] LPCSTR lpFileName,
  [in] HANDLE hTransaction
);

參數

[in] lpFileName

要刪除的檔案的名稱。

根據預設，名稱限製為MAX_PATH個字元。 若要將此限制延伸至 32,767 寬字元，請在路徑前面加上 “\\？\”。 如需詳細資訊，請參閱命名檔案、路徑與命名空間。

提示

從 Windows 10 版本 1607 開始，您可以選擇移除MAX_PATH限制，而不需在前面加上 “\\？\”。 如需詳細資訊，請參閱 命名檔案、路徑和命名空間 的一節。

檔案必須位於本機計算機上;否則，函式會失敗，而且最後一個錯誤碼會設定為 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE。

[in] hTransaction

交易的句柄。 CreateTransaction 函式會傳回這個句柄。

傳回值

如果函式成功，則傳回非零的值。

如果函式失敗，傳回值為 0 (零) 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

如果應用程式嘗試刪除不存在的檔案， DeleteFileTransacted 函式 會失敗並 ERROR_FILE_NOT_FOUND。 如果檔案是只讀檔案，函式會失敗並 ERROR_ACCESS_DENIED。

下列清單會識別刪除、移除或關閉檔案的一些秘訣：

• 若要刪除唯讀檔案，您必須先移除唯讀屬性。
• 若要刪除或重新命名檔案，您必須擁有檔案的刪除許可權，或刪除父目錄中的子許可權。
• 若要以遞歸方式刪除目錄中的檔案，請使用 SHFileOperation 函式。
• 若要移除空目錄，請使用 RemoveDirectoryTransacted 函式 。
• 若要關閉開啟的檔案，請使用 CloseHandle 函式 。

如果您設定目錄具有刪除和刪除子系以外的所有存取權，而訪問控制清單 (會繼承新檔案的 ACL) ，則您可以建立檔案，而不需要刪除它。 不過，您可以建立檔案，然後在建立檔案時，取得您在所傳回句柄上要求的所有存取權。

如果您在建立檔案時要求刪除許可權，您可以使用該句柄刪除或重新命名檔案，但不能使用任何其他句柄來重新命名。 如需詳細資訊，請參閱 檔案安全性和訪問許可權。

如果應用程式嘗試刪除其他句柄已針對一般 I/O 開啟的檔案，或作為記憶體對應檔案，則 DeleteFileTransacted 函 式會失敗 (FILE_SHARE_DELETE 必須在其他句柄開啟時指定) 。

DeleteFileTransacted 函式會標示要關閉刪除的檔案。 檔案會在檔案的最後一個交易寫入器句柄關閉之後刪除，前提是交易仍在使用中。 如果檔案標示為要刪除，且交易寫入器句柄在交易完成之後仍然開啟，則不會刪除檔案。

符號連結： 如果路徑指向符號連結，則會刪除符號連結，而不是目標。 若要刪除目標，您必須呼叫 CreateFile 並指定 FILE_FLAG_DELETE_ON_CLOSE。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。

技術	支援
伺服器消息塊 (SMB) 3.0 通訊協定	No
SMB 3.0 透明故障轉移 (TFO)	No
具有向外延展檔案共用的SMB 3.0 (SO)	No
叢集共用磁碟區文件系統 (CsvFS)	No
彈性檔案系統 (ReFS)	No

 

SMB 3.0 不支援 TxF。

注意

winbase.h 標頭會根據 UNICODE 預處理器常數的定義，將 DeleteFileTransacted 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

CloseHandle

CreateFileTransacted

檔案管理功能

符號連結

交易式 NTFS