DELETE_USN_JOURNAL_DATA 結構 (winioctl.h)
包含使用 FSCTL_DELETE_USN_JOURNAL 控制程式代碼刪除USN) 變更日誌 (更新序號的相關信息。
語法
typedef struct {
DWORDLONG UsnJournalID;
DWORD DeleteFlags;
} DELETE_USN_JOURNAL_DATA, *PDELETE_USN_JOURNAL_DATA;
成員
UsnJournalID
要刪除之變更日誌的標識碼。
如果在 DeleteFlags 成員中設定USN_DELETE_FLAG_DELETE旗標來要求日誌,則此標識碼必須指定目前磁碟區的變更日誌。 使用 FSCTL_QUERY_USN_JOURNAL 擷取此變更日誌的標識碼。 如果在此情況下,標識碼不是目前磁碟區的變更日誌, FSCTL_DELETE_USN_JOURNAL 就會失敗。
如果只藉由在 DeleteFlags中設定USN_DELETE_FLAG_NOTIFY旗標來要求通知, 則會忽略UsnJournalID 。
DeleteFlags
指出是否執行刪除或有關刪除的通知,或同時執行兩者。 DeleteFlags 成員必須包含下列其中一個或兩個值。
值 | 意義 |
---|---|
|
如果設定此旗標且未設定USN_DELETE_FLAG_NOTIFY旗標, 則FSCTL_DELETE_USN_JOURNAL 作業會啟動日誌刪除程式並立即傳回。 視需要,在系統重新啟動時,日誌刪除程式會繼續。
如果已設定此旗標,而且也會設定USN_DELETE_FLAG_NOTIFY旗標,則會同時刪除和通知。 如果設定此旗標且日誌為使用中,您必須為 UsnJournalID 中目前磁碟區的變更日誌提供識別符,否則作業會失敗。 如果日誌未使用中,則會忽略 UsnJournalID ,並刪除日誌。 |
|
如果設定此旗標,則呼叫會設定有關刪除完成時的通知。 當日誌刪除程式完成時,就會完成日誌刪除要求。 如果設定此旗標且未設定USN_DELETE_FLAG_DELETE旗標,則呼叫會設定可能正在進行刪除的通知。 例如,當您的應用程式啟動時,它可能會使用此旗標來判斷刪除是否正在進行中。
如果已設定此旗標,而且也會設定USN_DELETE_FLAG_DELETE旗標,則會同時刪除和通知。 通知是使用 I/O 完成埠或其他異步事件通知的機制來執行。 |
備註
如需詳細資訊,請參閱建立、修改和刪除變更 日誌。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
標頭 | winioctl.h (包含 Windows.h) |