FSCTL_ENUM_USN_DATA IOCTL (winioctl.h)

  • Artículo

Enumera los datos del número de secuencia de actualización (USN) entre dos límites especificados para obtener registros de tabla de archivos maestros (MFT).

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

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

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

Para enumerar los archivos de un volumen, use la operación de FSCTL_ENUM_USN_DATA una o varias veces. En la primera llamada, establezca el punto inicial, el miembro StartFileReferenceNumber de la estructura MFT_ENUM_DATA , en (DWORDLONG)0. Cada llamada a FSCTL_ENUM_USN_DATA recupera el punto inicial de la llamada posterior como primera entrada en el búfer de salida.

Al comparar Para identificar los cambios recientes en un volumen, use el código de control FSCTL_READ_USN_JOURNAL .

Para recuperar un identificador de un volumen, llame a CreateFile con el parámetro lpFileName establecido en una cadena con el formato 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 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

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluye Windows.h)

Vea también

CreateFile

DeviceIoControl

FSCTL_READ_USN_JOURNAL

GetOverlappedResult

MFT_ENUM_DATA

COMPROMETIDOS

USN_RECORD

Códigos de control de administración del volumen