FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Artículo

Recupera la información del diario de cambios de los números de secuencias actualizadas (USN) para el archivo o directorio especificado.

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

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                 (DWORD) FSCTL_READ_FILE_USN_DATA, // 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

Comentarios

Si la llamada se realiza correctamente, los miembros de la estructura de USN_RECORD_V2 o USN_RECORD_V3 devuelta son válidos excepto para los siguientes miembros: TimeStamp, Reason y SourceInfo. El miembro Usn representa el último USN escrito en el diario para este archivo o directorio.

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

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

\.\X:

En la cadena anterior, X es la letra que identifica la unidad en la que aparece el volumen. El volumen debe ser ReFS o NTFS 3.0 o posterior. Para obtener la versión NTFS de un volumen, abra un símbolo del sistema con derechos de acceso de administrador y ejecute el comando siguiente:

FSUtil.exe FSInfo NTFSInfo X:

donde X es la letra de unidad del volumen.

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

Tecnología Compatible
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í

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 (incluya Windows.h)

Consulte también

CreateFile

DeviceIoControl

USN_RECORD

Códigos de control de administración del volumen