共用方式為


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]: None。 設定為 NULL。

  • OutputBufferLength [out]:設定為 0。

狀態區塊

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

Code 意義
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