FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

Artículo
06/27/2024

Recupera el conjunto de registros de diario de cambios de número de secuencia de actualización (USN) entre dos valores DE USN especificados.

C++
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode (LPVOID) lpInBuffer, // input buffer (DWORD) nInBufferSize, // size of input buffer (LPVOID) lpOutBuffer, // output buffer (DWORD) nOutBufferSize, // size of output buffer (LPDWORD) lpBytesReturned, // number of bytes returned (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

C++

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to volume
                 (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode
                 (LPVOID)       lpInBuffer,      // input buffer
                 (DWORD)        nInBufferSize,   // size of input buffer
                 (LPVOID)       lpOutBuffer,     // output buffer
                 (DWORD)        nOutBufferSize,  // size of output buffer
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Observaciones

Para conocer las implicaciones de la E/S superpuesta en esta operación, vea la sección Comentarios del tema DeviceIoControl.

Hay dos códigos de control DeviceIoControl que devuelven registros USN, FSCTL_READ_USN_JOURNAL y FSCTL_ENUM_USN_DATA. Use este último cuando desee una lista (enumeración) de los registros USN entre dos USN. Use el anterior cuando quiera seleccionar por USN.

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

Para recuperar un identificador de un volumen, llame a CreateFile con el parámetro lpFileName establecido en una cadena de la forma siguiente:

\\.\X:

En la cadena anterior, X es la letra que identifica la unidad en la que aparece el volumen. El volumen debe ser NTFS.

En Windows 8 y Windows Server 2012, este código es compatible con las siguientes tecnologías.

Tecnología	Soportado
Protocolo bloque de mensajes del servidor (SMB) 3.0	No
Conmutación por error transparente (TFO) de SMB 3.0	No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)	No
Sistema de archivos de volumen compartido de clúster (CsvFS)	Ver comentario

Una aplicación puede experimentar falsos positivos en csvFs pause/resume.

Ejemplos

Para obtener un ejemplo, vea caminar un búfer de registros de diario de cambios.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	winioctl.h (incluya Windows.h)