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_BUFFER 或 REPARSE_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.h 或 Fltkernel.h) |