estructura DELETE_USN_JOURNAL_DATA (winioctl.h)

  • Artículo

Contiene información sobre la eliminación de un diario de cambios de números de secuencias actualizadas (USN) mediante el código de control FSCTL_DELETE_USN_JOURNAL.

Sintaxis

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

Miembros

UsnJournalID

Identificador del diario de cambios que se va a eliminar.

Si el diario está activo y se solicita la eliminación estableciendo la marca USN_DELETE_FLAG_DELETE en el miembro DeleteFlags , este identificador debe especificar el diario de cambios para el volumen actual. Use FSCTL_QUERY_USN_JOURNAL para recuperar el identificador de este diario de cambios. Si en este caso el identificador no es para el diario de cambios del volumen actual, FSCTL_DELETE_USN_JOURNAL produce un error.

Si se solicita notificación en lugar de eliminación estableciendo solo la marca USN_DELETE_FLAG_NOTIFY en DeleteFlags, se omite UsnJournalID .

DeleteFlags

Indica si se realiza la eliminación o notificación con respecto a la eliminación, o ambas. El miembro DeleteFlags debe contener uno o ambos de los valores siguientes.

Valor Significado
USN_DELETE_FLAG_DELETE
0x00000001
 Si se establece esta marca y no se establece la marca USN_DELETE_FLAG_NOTIFY, la operación de FSCTL_DELETE_USN_JOURNAL inicia el proceso de eliminación del diario y devuelve inmediatamente. El proceso de eliminación del diario continúa, si es necesario, en los reinicios del sistema.

Si se establece esta marca y también se establece la marca USN_DELETE_FLAG_NOTIFY, se producen la eliminación y la notificación. Si se establece esta marca y el diario está activo, debe proporcionar el identificador del diario de cambios para el volumen actual en UsnJournalID o se produce un error en la operación. Si el diario no está activo, se omite UsnJournalID y se elimina el diario.
USN_DELETE_FLAG_NOTIFY
0x00000002
 Si se establece esta marca, la llamada configura la notificación sobre cuándo se completa la eliminación. La solicitud de eliminación del diario se completa cuando se completa el proceso de eliminación del diario. Si se establece esta marca y no se establece la marca USN_DELETE_FLAG_DELETE, la llamada configura la notificación de una eliminación que puede estar en curso. Por ejemplo, cuando se inicia la aplicación, podría usar esta marca para determinar si una eliminación está en curso.

Si se establece esta marca y también se establece la marca USN_DELETE_FLAG_DELETE, se producen la eliminación y la notificación. La notificación se realiza mediante un puerto de finalización de E/S u otro mecanismo para la notificación de eventos asincrónica.

Comentarios

Para obtener más información, vea Crear, modificar y eliminar un Journal de cambios.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluye Windows.h)

Consulte también

FSCTL_DELETE_USN_JOURNAL

FSCTL_QUERY_USN_JOURNAL