FSCTL_QUERY_USN_JOURNAL IOCTL (winioctl.h)

Artículo
06/27/2024

Consulta información sobre el diario de cambios actual del número de secuencia de actualización (USN), sus registros y su capacidad.

C++
BOOL WINAPI DeviceIoControl( (HANDLE) Device, // handle to volume (DWORD) FSCTL_QUERY_USN_JOURNAL,// dwIoControlCode (LPVOID) NULL, // lpInBuffer (DWORD) 0, // nInBufferSize (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)       Device,          // handle to volume
                 (DWORD) FSCTL_QUERY_USN_JOURNAL,// dwIoControlCode
                 (LPVOID)       NULL,            // lpInBuffer
                 (DWORD)        0,               // nInBufferSize
                 (LPVOID)       lpOutBuffer,     // output buffer
                 (DWORD)        nOutBufferSize,  // size of output buffer
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Para realizar esta operación, llame a la función DeviceIoControl mediante los parámetros siguientes.

Observaciones

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

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 tener el formato del sistema de archivos 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)	Sí

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

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)