Compartir a través de


FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

Recupera la información del diario de cambios del número de secuencia de actualización (USN) del archivo o directorio especificados.

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

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

Observaciones

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 miembros siguientes: TimeStamp, Reasony 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 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 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 siguiente comando:

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 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)

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)

Consulte también

CreateFile

DeviceIoControl

USN_RECORD

códigos de control de administración de volúmenes