estructura MARK_HANDLE_INFO32 (winioctl.h)
Contiene información que se usa para marcar un archivo o directorio especificados y su registro de diario de cambios de número de secuencia de actualización (USN) con datos sobre los cambios. Esto solo se define para código de 64 bits y existe para interpretar MARK_HANDLE_INFO estructuras enviadas por código de 32 bits. Lo usa el código de control FSCTL_MARK_HANDLE IOCTL .
Sintaxis
typedef struct _MARK_HANDLE_INFO32 {
union {
DWORD UsnSourceInfo;
DWORD CopyNumber;
} DUMMYUNIONNAME;
DWORD UsnSourceInfo;
UINT32 VolumeHandle;
DWORD HandleInfo;
} MARK_HANDLE_INFO32, *PMARK_HANDLE_INFO32;
Members
DUMMYUNIONNAME
DUMMYUNIONNAME.UsnSourceInfo
DUMMYUNIONNAME.CopyNumber
UsnSourceInfo
Tipo de cambios que se están realizando.
La operación no modifica el archivo o directorio externamente desde el punto de vista de la aplicación que la creó.
Cuando un subproceso escribe un nuevo registro USN, las marcas de información de origen del registro anterior siguen estando presentes solo si el subproceso también establece esas marcas. Por lo tanto, la estructura de información de origen permite que las aplicaciones filtren los registros USN establecidos solo por un origen conocido, como un filtro antivirus.
Se definen los valores siguientes.
| Value | Significado |
|---|---|
|
La operación proporciona información sobre un cambio en el archivo o directorio realizado por el sistema operativo.
Un uso típico es cuando el almacenamiento remoto mueve datos de un almacenamiento externo a otro local. El almacenamiento remoto es el software de administración de almacenamiento jerárquico. Este movimiento suele agregar como mínimo la marca USN_REASON_DATA_OVERWRITE a un registro USN. Sin embargo, los datos no han cambiado desde el punto de vista del usuario. Al señalar USN_SOURCE_DATA_MANAGEMENT en el miembro SourceInfo de la estructura USN_RECORD que contiene el registro, puede determinar que, aunque se realiza una operación de escritura en el elemento, los datos no han cambiado. |
|
La operación agrega un flujo de datos privado a un archivo o directorio.
Un ejemplo podría ser un detector de virus que agrega información de suma de comprobación. A medida que el detector de virus modifica el elemento, el sistema genera registros USN. USN_SOURCE_AUXILIARY_DATA indica que las modificaciones no cambiaron los datos de la aplicación. |
|
La operación crea o actualiza el contenido de un archivo replicado.
Por ejemplo, el servicio de replicación de archivos establece esta marca cuando crea o actualiza un archivo en un directorio replicado. |
VolumeHandle
Identificador de volumen al volumen donde reside el archivo o directorio. Para obtener más información sobre cómo obtener un identificador de volumen, vea la sección Comentarios.
Este identificador es necesario para comprobar los privilegios de esta operación.
El autor de la llamada debe tener el privilegio SE_MANAGE_VOLUME_NAME . Para obtener más información, consulte Privilegios.
HandleInfo
Marca que especifica información adicional sobre el archivo o directorio identificado por el valor de identificador en el miembro VolumeHandle .
| Value | Significado |
|---|---|
|
El archivo se marca como no se puede desfragmentar hasta que se cierra el identificador. |
|
El archivo se marca como no se puede desfragmentar hasta que se cierra el identificador. |
|
El archivo se marca como no se puede desfragmentar hasta que se cierra el identificador. |
|
El archivo está marcado para el comportamiento de lectura en tiempo real, independientemente del tipo de archivo real. Los archivos marcados con esta marca deben abrirse para E /S sin búfer. |
|
El archivo marcado previamente para el comportamiento de lectura en tiempo real mediante la marca MARK_HANDLE_REALTIME se puede desmarcar mediante esta marca, quitando el comportamiento en tiempo real. Los archivos marcados con esta marca deben abrirse para E /S sin búfer. |
Requisitos
| Cliente mínimo compatible | Windows 8 (solo 64 bits) [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Encabezado | winioctl.h (incluye Windows.h) |