共用方式為


FSCTL_DELETE_EXTERNAL_BACKING控件程式代碼

FSCTL_DELETE_EXTERNAL_BACKING控件程式代碼會移除檔案與外部備份提供者的關聯,包括 Windows 映像格式 (WIM) 提供者或壓縮檔提供者。 由於這項作業,所支援檔案的整個內容都會讀取、解壓縮並寫入檔案。

若要執行這項作業,請使用下列參數呼叫 FltFsControlFileZwFsControlFile

參數

  • 實例 [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。

狀態區塊

FltFsControlFileZwFsControlFile 會在作業成功時傳回STATUS_SUCCESS。 否則,適當的函式可能會傳回下列其中一個NTSTATUS值。

程式碼 意義
STATUS_OBJECT_NOT_EXTERNALLY_BACKED 檔案不是外部支援。
STATUS_INVALID_DEVICE_REQUEST 備份服務不存在或未啟動。
STATUS_ACCESS_DENIED 要求者沒有許可權可刪除檔案的備份關聯。

備註

由於刪除作業,會從備份來源讀取檔案的內容,並將整個檔案寫入磁碟區。

規格需求

需求類型 需求
最低支援的用戶端 Windows 8.1 更新版
標頭 Ntifs.h (包括 Ntifs.hFltkernel.h)

另請參閱

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING