FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)
Genera un registro en el flujo de diario de cambios del número de secuencia de actualización (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 parámetros siguientes.
| 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
|
Observaciones
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 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 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 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) | Sí |
Operaciones de transacción de
Si se llama a FSCTL_WRITE_USN_CLOSE_RECORD con un identificador bloqueado por una transacción, siempre se produce un error.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) |