DELETE_USN_JOURNAL_DATA structure (winioctl.h)

Article
03/08/2023

Contient des informations sur la suppression d’un journal de modifications du nombre de séquences de mise à jour (USN) à l’aide du code de contrôle FSCTL_DELETE_USN_JOURNAL.

Syntaxe

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

Membres

UsnJournalID

Identificateur du journal des modifications à supprimer.

Si le journal est actif et que la suppression est demandée en définissant l’indicateur USN_DELETE_FLAG_DELETE dans le membre DeleteFlags , cet identificateur doit spécifier le journal des modifications pour le volume actuel. Utilisez FSCTL_QUERY_USN_JOURNAL pour récupérer l’identificateur de ce journal des modifications. Si dans ce cas, l’identificateur ne correspond pas au journal des modifications du volume actuel, FSCTL_DELETE_USN_JOURNAL échoue.

Si la notification au lieu de la suppression est demandée en définissant uniquement l’indicateur USN_DELETE_FLAG_NOTIFY dans DeleteFlags, UsnJournalID est ignoré.

DeleteFlags

Indique si la suppression ou la notification concernant la suppression est effectuée, ou les deux. Le membre DeleteFlags doit contenir une ou les deux valeurs suivantes.

Valeur	Signification
USN_DELETE_FLAG_DELETE 0x00000001	Si cet indicateur est défini et que l’indicateur USN_DELETE_FLAG_NOTIFY n’est pas défini, l’opération FSCTL_DELETE_USN_JOURNAL démarre le processus de suppression du journal et retourne immédiatement. Le processus de suppression du journal se poursuit, si nécessaire, au cours des redémarrages du système. Si cet indicateur est défini et que l’indicateur USN_DELETE_FLAG_NOTIFY est également défini, la suppression et la notification se produisent. Si cet indicateur est défini et que le journal est actif, vous devez fournir l’identificateur du journal des modifications pour le volume actuel dans UsnJournalID , sinon l’opération échoue. Si le journal n’est pas actif, UsnJournalID est ignoré et le journal est supprimé.
USN_DELETE_FLAG_NOTIFY 0x00000002	Si cet indicateur est défini, l’appel configure une notification indiquant quand la suppression est terminée. La demande de suppression de journal est terminée lorsque le processus de suppression de journal est terminé. Si cet indicateur est défini et que l’indicateur USN_DELETE_FLAG_DELETE n’est pas défini, l’appel configure la notification d’une suppression qui est peut-être déjà en cours. Par exemple, lorsque votre application démarre, elle peut utiliser cet indicateur pour déterminer si une suppression est en cours. Si cet indicateur est défini et que l’indicateur USN_DELETE_FLAG_DELETE est également défini, la suppression et la notification se produisent. La notification est effectuée à l’aide d’un port d’achèvement d’E/S ou d’un autre mécanisme de notification d’événement asynchrone.

Valeur

Signification

USN_DELETE_FLAG_DELETE
0x00000001

Si cet indicateur est défini et que l’indicateur USN_DELETE_FLAG_NOTIFY n’est pas défini, l’opération FSCTL_DELETE_USN_JOURNAL démarre le processus de suppression du journal et retourne immédiatement. Le processus de suppression du journal se poursuit, si nécessaire, au cours des redémarrages du système.

Si cet indicateur est défini et que l’indicateur USN_DELETE_FLAG_NOTIFY est également défini, la suppression et la notification se produisent. Si cet indicateur est défini et que le journal est actif, vous devez fournir l’identificateur du journal des modifications pour le volume actuel dans UsnJournalID , sinon l’opération échoue. Si le journal n’est pas actif, UsnJournalID est ignoré et le journal est supprimé.

USN_DELETE_FLAG_NOTIFY
0x00000002

Si cet indicateur est défini, l’appel configure une notification indiquant quand la suppression est terminée. La demande de suppression de journal est terminée lorsque le processus de suppression de journal est terminé. Si cet indicateur est défini et que l’indicateur USN_DELETE_FLAG_DELETE n’est pas défini, l’appel configure la notification d’une suppression qui est peut-être déjà en cours. Par exemple, lorsque votre application démarre, elle peut utiliser cet indicateur pour déterminer si une suppression est en cours.

Si cet indicateur est défini et que l’indicateur USN_DELETE_FLAG_DELETE est également défini, la suppression et la notification se produisent. La notification est effectuée à l’aide d’un port d’achèvement d’E/S ou d’un autre mécanisme de notification d’événement asynchrone.

Remarques

Pour plus d’informations, consultez Création, modification et suppression d’un Journal de modification.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	winioctl.h (inclure Windows.h)

Voir aussi

FSCTL_DELETE_USN_JOURNAL

FSCTL_QUERY_USN_JOURNAL