FSCTL_DELETE_EXTERNAL_BACKING控件程式代碼
FSCTL_DELETE_EXTERNAL_BACKING控件程式代碼會移除檔案與外部備份提供者的關聯,包括 Windows 映像格式 (WIM) 提供者或壓縮檔提供者。 由於這項作業,所支援檔案的整個內容都會讀取、解壓縮並寫入檔案。
若要執行這項作業,請使用下列參數呼叫 FltFsControlFile 或 ZwFsControlFile 。
參數
實例 [in]: 僅 FltFsControlFile 。 呼叫端的不透明實例指標。 這個參數是必要的,而且不能是 NULL。
FileObject: [in]: FltFsControlFile 。 刪除支持關聯之檔案的檔案指針對象。 這個參數是必要的,而且不能是 NULL。
FileHandle [in]:僅限 ZwFsControlFile 。 刪除支持關聯之檔案的句柄。 這個參數是必要的,而且不能是 NULL。
FsControlCode [in]:作業的控制程序代碼。 針對此作業使用 FSCTL_DELETE_EXTERNAL_BACKING 。
InputBuffer [in]:無。 設定為 NULL。
InputBufferLength [in]:設定為 0。
OutputBuffer [out]:無。 設定為 NULL。
OutputBufferLength [out]:設定為 0。
狀態區塊
FltFsControlFile 或 ZwFsControlFile 會在作業成功時傳回STATUS_SUCCESS。 否則,適當的函式可能會傳回下列其中一個NTSTATUS值。
程式碼 | 意義 |
---|---|
STATUS_OBJECT_NOT_EXTERNALLY_BACKED | 檔案不是外部支援。 |
STATUS_INVALID_DEVICE_REQUEST | 備份服務不存在或未啟動。 |
STATUS_ACCESS_DENIED | 要求者沒有許可權可刪除檔案的備份關聯。 |
備註
由於刪除作業,會從備份來源讀取檔案的內容,並將整個檔案寫入磁碟區。
規格需求
需求類型 | 需求 |
---|---|
最低支援的用戶端 | Windows 8.1 更新版 |
標頭 | Ntifs.h (包括 Ntifs.h 或 Fltkernel.h) |