FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)

  • Artículo

Genera un registro en el flujo de diario de cambios de los números de secuencias actualizadas (USN) para el archivo de entrada. Este registro tendrá la marca USN_REASON_CLOSE .

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

C++ 
BOOL 
WINAPI
DeviceIoControl( (HANDLE) hDevice,              // handle to volume
                 FSCTL_WRITE_USN_CLOSE_RECORD,  // dwIoControlCodeNULL,                          // lpInBuffer0,                             // nInBufferSize(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 de DeviceIoControl.

Puede usar FSCTL_WRITE_USN_CLOSE_RECORD para forzar un registro de cierre en el diario de cambios para el identificador de entrada. El registro de cierre contendrá también los motivos actuales de USN para este archivo. El búfer de salida devolverá el valor USN asociado a esta operación.

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

Operaciones de transacción

Si se llama a FSCTL_WRITE_USN_CLOSE_RECORD con un identificador bloqueado por una transacción, siempre se produce un error.

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

Diarios de cambios

CreateFile

DeviceIoControl

OVERLAPPED

Códigos de control de administración del volumen