共用方式為


FSCTL_DELETE_REPARSE_POINT控件程式代碼

FSCTL_DELETE_REPARSE_POINT控件程式代碼會從指定的檔案或目錄刪除重新分析點。 使用 FSCTL_DELETE_REPARSE_POINT 不會刪除檔案或目錄。

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

迷你篩選應該使用 FltUntagFile ,而不是FSCTL_DELETE_REPARSE_POINT來刪除重新分析點。

如需重新分析點和FSCTL_DELETE_REPARSE_POINT控制程式代碼的詳細資訊,請參閱 Microsoft Windows SDK 檔。

參數

  • FileHandle [in]:要從中刪除重新分析點之檔案或目錄的檔案句柄。 呼叫端必須具有檔案或目錄的寫入許可權。 這個參數是必要的,而且不能是 NULL

  • FsControlCode [in]:作業的控制程序代碼。 針對此作業使用FSCTL_DELETE_REPARSE_POINT。

  • InputBuffer [in]: REPARSE_GUID_DATA_BUFFERREPARSE_DATA_BUFFER 結構的指標。 此結構的 ReparseTag 成員中指定的標記必須符合要刪除之重新分析點的標記,且 ReparseDataLength 成員必須為零。 此外,如果重新分析點是第三方 (非 Microsoft) 重新分析點,REPARSE_GUID_DATA_BUFFER 結構的 ReparseGuid 成員中指定的 GUID 必須符合要刪除之重新分析點的 GUID。

  • InputBufferLength [in]: InputBuffer 參數所指向緩衝區的大小,以位元組為單位。 對於REPARSE_GUID_DATA_BUFFER結構,此值必須完全REPARSE_GUID_DATA_BUFFER_HEADER_SIZE。 對於REPARSE_DATA_BUFFER結構,此值必須完全REPARSE_DATA_BUFFER_HEADER_SIZE。

  • OutputBuffer [out]:無。 設定為 NULL。

  • OutputBufferLength [out]:設定為 0。

狀態區塊

ZwFsControlFile 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值,例如下列其中一項:

程式碼 意義
STATUS_IO_REPARSE_DATA_INVALID 其中一個指定的參數值無效。 這是錯誤碼。
STATUS_IO_REPARSE_TAG_INVALID 呼叫端指定的重新分析標記無效。 這是錯誤碼。
STATUS_IO_REPARSE_TAG_MISMATCH 呼叫端所指定的重新分析標記不符合要刪除之重新分析點的標記。 這是錯誤碼。
STATUS_REPARSE_ATTRIBUTE_CONFLICT 重新分析點是第三方重新分析點,而呼叫端指定的重新分析 GUID 與要刪除之重新分析點的 GUID 不符。 這是錯誤碼。

規格需求

需求類型 需求
標頭 Ntifs.h (包括 Ntifs.hFltkernel.h)

另請參閱

IRP_MJ_FILE_SYSTEM_CONTROL的FLT_PARAMETERS

FltTagFile

FltUntagFile

FSCTL_GET_REPARSE_POINT

FSCTL_SET_REPARSE_POINT

IRP_MJ_FILE_SYSTEM_CONTROL

IsReparseTagMicrosoft

IsReparseTagNameSurrogate

REPARSE_DATA_BUFFER

REPARSE_GUID_DATA_BUFFER

ZwFsControlFile