DELETE_USN_JOURNAL_DATA Struktur (winioctl.h)

Artikel
03/04/2024

Enthält Informationen zum Löschen eines Änderungsjournals für die Updatesequenznummer (USN) mithilfe des Steuerungscodes FSCTL_DELETE_USN_JOURNAL.

Syntax

typedef struct {
  DWORDLONG UsnJournalID;
  DWORD     DeleteFlags;
} DELETE_USN_JOURNAL_DATA, *PDELETE_USN_JOURNAL_DATA;

Member

UsnJournalID

Der Bezeichner des zu löschenden Änderungsjournals.

Wenn das Journal aktiv ist und das Löschen durch Festlegen des USN_DELETE_FLAG_DELETE-Flags im DeleteFlags-Element angefordert wird, muss dieser Bezeichner das Änderungsjournal für das aktuelle Volume angeben. Verwenden Sie FSCTL_QUERY_USN_JOURNAL , um den Bezeichner dieses Änderungsjournals abzurufen. Wenn in diesem Fall der Bezeichner nicht für das Änderungsjournal des aktuellen Volumes gilt, schlägt FSCTL_DELETE_USN_JOURNAL fehl.

Wenn Benachrichtigung anstelle des Löschens angefordert wird, indem nur das USN_DELETE_FLAG_NOTIFY-Flag in DeleteFlags festgelegt wird, wird UsnJournalID ignoriert.

DeleteFlags

Gibt an, ob das Löschen oder die Benachrichtigung zum Löschen oder beides ausgeführt wird. Das DeleteFlags-Element muss einen oder beide der folgenden Werte enthalten.

Wert	Bedeutung
USN_DELETE_FLAG_DELETE 0x00000001	Wenn dieses Flag festgelegt ist und das USN_DELETE_FLAG_NOTIFY-Flag nicht festgelegt ist, startet der FSCTL_DELETE_USN_JOURNAL Vorgang den Journallöschvorgang und gibt sofort zurück. Der Journallöschvorgang wird bei Bedarf über systemübergreifende Neustarts fortgesetzt. Wenn dieses Flag festgelegt ist und das USN_DELETE_FLAG_NOTIFY-Flag ebenfalls festgelegt ist, werden sowohl das Löschen als auch die Benachrichtigung ausgeführt. Wenn dieses Flag festgelegt ist und das Journal aktiv ist, müssen Sie den Bezeichner für das Änderungsjournal für das aktuelle Volume in UsnJournalID angeben, andernfalls schlägt der Vorgang fehl. Wenn das Journal nicht aktiv ist, wird UsnJournalID ignoriert, und das Journal wird gelöscht.
USN_DELETE_FLAG_NOTIFY 0x00000002	Wenn dieses Flag festgelegt ist, richtet der Aufruf eine Benachrichtigung über den Abschluss des Löschvorgangs ein. Die Journallöschanforderung ist abgeschlossen, wenn der Löschvorgang des Journals abgeschlossen ist. Wenn dieses Flag festgelegt ist und das USN_DELETE_FLAG_DELETE-Flag nicht festgelegt ist, richtet der Aufruf eine Benachrichtigung über einen Löschvorgang ein, der möglicherweise bereits ausgeführt wird. Wenn Ihre Anwendung beispielsweise gestartet wird, kann sie dieses Flag verwenden, um zu bestimmen, ob ein Löschvorgang ausgeführt wird. Wenn dieses Flag festgelegt ist und das USN_DELETE_FLAG_DELETE-Flag ebenfalls festgelegt ist, erfolgt sowohl das Löschen als auch die Benachrichtigung. Die Benachrichtigung wird mithilfe eines E/A-Vervollständigungsports oder eines anderen Mechanismus für asynchrone Ereignisbenachrichtigungen ausgeführt.

Wert

Bedeutung

USN_DELETE_FLAG_DELETE
0x00000001

Wenn dieses Flag festgelegt ist und das USN_DELETE_FLAG_NOTIFY-Flag nicht festgelegt ist, startet der FSCTL_DELETE_USN_JOURNAL Vorgang den Journallöschvorgang und gibt sofort zurück. Der Journallöschvorgang wird bei Bedarf über systemübergreifende Neustarts fortgesetzt.

Wenn dieses Flag festgelegt ist und das USN_DELETE_FLAG_NOTIFY-Flag ebenfalls festgelegt ist, werden sowohl das Löschen als auch die Benachrichtigung ausgeführt. Wenn dieses Flag festgelegt ist und das Journal aktiv ist, müssen Sie den Bezeichner für das Änderungsjournal für das aktuelle Volume in UsnJournalID angeben, andernfalls schlägt der Vorgang fehl. Wenn das Journal nicht aktiv ist, wird UsnJournalID ignoriert, und das Journal wird gelöscht.

USN_DELETE_FLAG_NOTIFY
0x00000002

Wenn dieses Flag festgelegt ist, richtet der Aufruf eine Benachrichtigung über den Abschluss des Löschvorgangs ein. Die Journallöschanforderung ist abgeschlossen, wenn der Löschvorgang des Journals abgeschlossen ist. Wenn dieses Flag festgelegt ist und das USN_DELETE_FLAG_DELETE-Flag nicht festgelegt ist, richtet der Aufruf eine Benachrichtigung über einen Löschvorgang ein, der möglicherweise bereits ausgeführt wird. Wenn Ihre Anwendung beispielsweise gestartet wird, kann sie dieses Flag verwenden, um zu bestimmen, ob ein Löschvorgang ausgeführt wird.

Wenn dieses Flag festgelegt ist und das USN_DELETE_FLAG_DELETE-Flag ebenfalls festgelegt ist, erfolgt sowohl das Löschen als auch die Benachrichtigung. Die Benachrichtigung wird mithilfe eines E/A-Vervollständigungsports oder eines anderen Mechanismus für asynchrone Ereignisbenachrichtigungen ausgeführt.

Hinweise

Weitere Informationen finden Sie unter Erstellen, Ändern und Löschen einer Änderung Journal.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winioctl.h (einschließlich Windows.h)

Weitere Informationen

FSCTL_DELETE_USN_JOURNAL

FSCTL_QUERY_USN_JOURNAL

Freigeben über