DeleteFileW 函式 （fileapi.h）
刪除現有的檔案。
若要以交易作業的形式執行此作業，請使用 DeleteFileTransacted 函式。
語法
BOOL DeleteFileW(
[in] LPCWSTR lpFileName
);
參數
[in] lpFileName
要刪除的檔名。
根據預設，名稱限製為MAX_PATH個字元。 若要將此限制延伸至 32,767 寬字元，請在路徑前面加上 “\\？\”。 如需詳細資訊，請參閱 命名檔案、路徑和命名空間。
提示
從 Windows 10 版本 1607 開始，您可以選擇移除MAX_PATH限制，而不需預先加上 “\\？\”。 如需詳細資訊，請參閱 命名檔案、路徑和命名空間 的一節。
傳回值
如果函式成功，則傳回值為非零值。
如果函式失敗，傳回值為零 （0）。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
言論
如果應用程式嘗試刪除不存在的檔案，DeleteFile 函式會失敗並 ERROR_FILE_NOT_FOUND。 如果檔案是唯讀檔案，函式會失敗，並 ERROR_ACCESS_DENIED。
下列清單會識別刪除、移除或關閉檔案的一些秘訣：
- 若要刪除唯讀檔案，您必須先移除唯讀屬性。
- 若要刪除或重新命名檔案，您必須擁有檔案的刪除許可權，或刪除父目錄中的子許可權。
- 若要遞歸刪除目錄中的檔案，請使用 SHFileOperation 函式。
- 若要移除空的目錄，請使用 RemoveDirectory 函式。
- 若要關閉開啟的檔案，請使用 CloseHandle 函式。
如果您設定具有刪除和刪除子系以外的所有存取權目錄，以及繼承新檔案的訪問控制清單 （ACL），則您可以建立檔案，而不需要刪除它。 不過，您可以建立檔案，然後取得您在建立檔案時傳回之句柄上要求的所有存取權。
如果您在建立檔案時要求刪除許可權，您可以使用該句柄刪除或重新命名檔案，但不能使用任何其他句柄來刪除或重新命名檔案。 如需詳細資訊，請參閱 檔案安全性和存取權限。
如果應用程式嘗試刪除其他句柄為一般 I/O 開啟的檔案，或做為記憶體對應檔案，則 DeleteFile 函式會失敗（FILE_SHARE_DELETE 必須在開啟其他句柄時指定）。
DeleteFile 函式會將檔案標示為關閉時要刪除的檔案。 因此，在關閉檔案的最後一個句柄之前，不會刪除檔案。 CreateFile 開啟檔案的後續呼叫失敗，ERROR_ACCESS_DENIED。
使用 POSIX 刪除會導致檔案在句柄保持開啟時刪除。 後續呼叫 CreateFile 以開啟檔案失敗，並 ERROR_FILE_NOT_FOUND。
符號連結行為：
如果路徑指向符號連結，則會刪除符號連結，而不是目標。 若要刪除目標，您必須呼叫 createFile 並指定 FILE_FLAG_DELETE_ON_CLOSE。
在 Windows 8 和 Windows Server 2012 中，下列技術支援此功能：
| 科技 | 支援 |
|---|---|
| 伺服器消息塊 （SMB） 3.0 通訊協定 | 是的 |
| SMB 3.0 透明故障轉移 （TFO） | 是的 |
| 具有向外延展檔案共用的SMB 3.0（SO） | 是的 |
| 叢集共用磁碟區檔案系統 （CsvFS） | 是的 |
| 復原檔案系統 （ReFS） | 是的 |
例子
如需範例，請參閱 檔案中的鎖定和解除鎖定位元組範圍。
注意
fileapi.h 標頭會將DeleteFile定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或Unicode版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | fileapi.h （包括 Windows.h） |
| 連結庫 | Kernel32.lib |
| DLL | Kernel32.dll |