DELETE_USN_JOURNAL_DATA struttura (winioctl.h)

Articolo
03/08/2023

Contiene informazioni sull'eliminazione di un journal di modifica del numero di sequenza di aggiornamento (USN) usando il codice di controllo FSCTL_DELETE_USN_JOURNAL .

Sintassi

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

Members

UsnJournalID

Identificatore del journal di modifica da eliminare.

Se il journal è attivo ed eliminato viene richiesto impostando il flag di USN_DELETE_FLAG_DELETE nel membro DeleteFlags , questo identificatore deve specificare il journal di modifica per il volume corrente. Usare FSCTL_QUERY_USN_JOURNAL per recuperare l'identificatore del journal di modifica. Se in questo caso l'identificatore non è per il journal di modifica del volume corrente, FSCTL_DELETE_USN_JOURNAL ha esito negativo.

Se la notifica anziché l'eliminazione viene richiesta impostando solo il flag di USN_DELETE_FLAG_NOTIFY in DeleteFlags, UsnJournalID viene ignorato.

DeleteFlags

Indica se l'eliminazione o la notifica relative all'eliminazione vengono eseguite o entrambe. Il membro DeleteFlags deve contenere uno o entrambi i valori seguenti.

Valore	Significato
USN_DELETE_FLAG_DELETE 0x00000001	Se questo flag è impostato e il flag di USN_DELETE_FLAG_NOTIFY non è impostato, l'operazione di FSCTL_DELETE_USN_JOURNAL avvia il processo di eliminazione del journal e restituisce immediatamente. Il processo di eliminazione del journal continua, se necessario, tra i riavvii del sistema. Se questo flag è impostato e viene impostato anche il flag USN_DELETE_FLAG_NOTIFY, si verificano sia l'eliminazione che la notifica. Se questo flag è impostato e il journal è attivo, è necessario specificare l'identificatore per il journal di modifica per il volume corrente in UsnJournalID o l'operazione ha esito negativo. Se il journal non è attivo, UsnJournalID viene ignorato e il journal viene eliminato.
USN_DELETE_FLAG_NOTIFY 0x00000002	Se questo flag è impostato, la chiamata configura la notifica relativa al completamento dell'eliminazione. La richiesta di eliminazione del journal viene completata al termine del processo di eliminazione del journal. Se questo flag è impostato e il flag di USN_DELETE_FLAG_DELETE non è impostato, la chiamata configura la notifica di un'eliminazione già in corso. Ad esempio, quando l'applicazione viene avviata, potrebbe usare questo flag per determinare se è in corso un'eliminazione. Se questo flag è impostato e viene impostato anche il flag USN_DELETE_FLAG_DELETE, si verificano sia l'eliminazione che la notifica. La notifica viene eseguita usando una porta di completamento di I/O o o o un altro meccanismo per la notifica degli eventi asincroni.

Valore

Significato

USN_DELETE_FLAG_DELETE
0x00000001

Se questo flag è impostato e il flag di USN_DELETE_FLAG_NOTIFY non è impostato, l'operazione di FSCTL_DELETE_USN_JOURNAL avvia il processo di eliminazione del journal e restituisce immediatamente. Il processo di eliminazione del journal continua, se necessario, tra i riavvii del sistema.

Se questo flag è impostato e viene impostato anche il flag USN_DELETE_FLAG_NOTIFY, si verificano sia l'eliminazione che la notifica. Se questo flag è impostato e il journal è attivo, è necessario specificare l'identificatore per il journal di modifica per il volume corrente in UsnJournalID o l'operazione ha esito negativo. Se il journal non è attivo, UsnJournalID viene ignorato e il journal viene eliminato.

USN_DELETE_FLAG_NOTIFY
0x00000002

Se questo flag è impostato, la chiamata configura la notifica relativa al completamento dell'eliminazione. La richiesta di eliminazione del journal viene completata al termine del processo di eliminazione del journal. Se questo flag è impostato e il flag di USN_DELETE_FLAG_DELETE non è impostato, la chiamata configura la notifica di un'eliminazione già in corso. Ad esempio, quando l'applicazione viene avviata, potrebbe usare questo flag per determinare se è in corso un'eliminazione.

Se questo flag è impostato e viene impostato anche il flag USN_DELETE_FLAG_DELETE, si verificano sia l'eliminazione che la notifica. La notifica viene eseguita usando una porta di completamento di I/O o o o un altro meccanismo per la notifica degli eventi asincroni.

Commenti

Per altre informazioni, vedere Creazione, modifica ed eliminazione di una modifica Journal.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)

Vedi anche

FSCTL_DELETE_USN_JOURNAL

FSCTL_QUERY_USN_JOURNAL

Share via