Función MoveFileTransactedA (winbase.h)
[Microsoft recomienda encarecidamente que los desarrolladores usen medios alternativos para lograr las necesidades de la aplicación. Muchos escenarios para los que se desarrolló TxF se pueden lograr mediante técnicas más sencillas y disponibles. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional].
Mueve un archivo o un directorio existente, así como sus elementos secundarios, como una operación de transacción.
Sintaxis
BOOL MoveFileTransactedA(
[in] LPCSTR lpExistingFileName,
[in, optional] LPCSTR lpNewFileName,
[in, optional] LPPROGRESS_ROUTINE lpProgressRoutine,
[in, optional] LPVOID lpData,
[in] DWORD dwFlags,
[in] HANDLE hTransaction
);
Parámetros
[in] lpExistingFileName
Nombre actual del archivo o directorio existente en el equipo local.
De forma predeterminada, el nombre está limitado a MAX_PATH caracteres. Para ampliar este límite a 32 767 caracteres anchos, anteponga "\\?\" a la ruta de acceso. Para obtener más información, vea Nomenclatura de archivos, rutas de acceso y espacios de nombres.
Sugerencia
A partir de Windows 10, versión 1607, puede optar por quitar la limitación de MAX_PATH sin prepending "\\?\". Consulte la sección "Limitación máxima de longitud de ruta de acceso" de Nombres de archivos, rutas de acceso y espacios de nombres para obtener más información.
[in, optional] lpNewFileName
Nuevo nombre del archivo o directorio. El nuevo nombre no debe existir. Un nuevo archivo puede encontrarse en otro sistema de archivos o unidad. Un nuevo directorio debe estar en la misma unidad.
De forma predeterminada, el nombre está limitado a MAX_PATH caracteres. Para ampliar este límite a 32 767 caracteres anchos, anteponga "\\?\" a la ruta de acceso. Para obtener más información, vea Nomenclatura de archivos, rutas de acceso y espacios de nombres.
Sugerencia
A partir de Windows 10, versión 1607, puede optar por quitar la limitación de MAX_PATH sin prepending "\\?\". Consulte la sección "Limitación máxima de longitud de ruta de acceso" de Nombres de archivos, rutas de acceso y espacios de nombres para obtener más información.
[in, optional] lpProgressRoutine
Puntero a una función de devolución de llamada CopyProgressRoutine a la que se llama cada vez que se ha movido otra parte del archivo. La función de devolución de llamada puede ser útil si proporciona una interfaz de usuario que muestra el progreso de la operación. Este parámetro puede ser NULL.
[in, optional] lpData
Argumento que se va a pasar a la función de devolución de llamada CopyProgressRoutine . Este parámetro puede ser NULL.
[in] dwFlags
Opciones de movimiento. Este parámetro puede ser uno o más de los siguientes valores.
| Valor | Significado |
|---|---|
|
Si el archivo se va a mover a un volumen diferente, la función simula el movimiento mediante las funciones CopyFile y DeleteFile .
Si el archivo se copia correctamente en un volumen diferente y el archivo original no se puede eliminar, la función se realiza correctamente dejando intacto el archivo de origen. Este valor no se puede usar con MOVEFILE_DELAY_UNTIL_REBOOT. |
|
Reservado para uso futuro. |
|
El sistema no mueve el archivo hasta que se reinicia el sistema operativo. El sistema mueve el archivo inmediatamente después de ejecutar AUTOCHK, pero antes de crear los archivos de paginación. Por lo tanto, este parámetro permite que la función elimine los archivos de paginación de las startups anteriores.
Este valor solo se puede usar si el proceso está en el contexto de un usuario que pertenece al grupo de administradores o a la cuenta LocalSystem. Este valor no se puede usar con MOVEFILE_COPY_ALLOWED. La operación de escritura en el valor del Registro tal como se detalla en la sección Comentarios es lo que se realiza con transacciones. El traslado de archivos finaliza cuando se reinicia el equipo, una vez completada la transacción. |
|
Si existe un archivo denominado lpNewFileName , la función reemplaza su contenido por el contenido del archivo lpExistingFileName .
Este valor no se puede usar si lpNewFileName o lpExistingFileName asigna un nombre a un directorio. |
|
Una llamada a MoveFileTransacted significa que la operación de mover archivo se completa cuando se completa la operación de confirmación. Esta marca no es necesaria; no hay ningún efecto negativo si se especifica esta marca, aparte de una ralentización de la operación. La función no devuelve hasta que el archivo se haya movido realmente en el disco.
Si se establece este valor, se garantiza que un movimiento realizado como operación de copia y eliminación se vacía en el disco antes de que la función devuelva. El vaciado se produce al final de la operación de copia. Este valor no tiene ningún efecto si se establece MOVEFILE_DELAY_UNTIL_REBOOT . |
[in] hTransaction
Identificador de la transacción. La función CreateTransaction devuelve este identificador.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Al mover un archivo entre volúmenes, si lpProgressRoutine devuelve PROGRESS_CANCEL debido a que el usuario cancela la operación, MoveFileTransacted devolverá cero y GetLastError devolverá ERROR_REQUEST_ABORTED. El archivo existente se deja intacto.
Al mover un archivo entre volúmenes, si lpProgressRoutine devuelve PROGRESS_STOP debido a que el usuario detiene la operación, MoveFileTransacted devolverá cero y GetLastError devolverá ERROR_REQUEST_ABORTED. El archivo existente se deja intacto.
Comentarios
Si el parámetro dwFlags especifica MOVEFILE_DELAY_UNTIL_REBOOT, MoveFileTransacted produce un error si no puede acceder al registro. La función almacena transaccionalmente las ubicaciones de los archivos cuyo nombre se va a cambiar al reiniciar en el siguiente valor del Registro: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\PendingFileRenameOperations
Este valor del Registro es de tipo REG_MULTI_SZ. Cada operación de cambio de nombre almacena una de las siguientes cadenas terminadas en NULL, en función de si el cambio de nombre es una eliminación o no:
szDstFile\0\0
szSrcFile\0szDstFile\0
La cadena szDstFile\0\0 indica que el archivo szDstFile se va a eliminar al reiniciar.
La cadena szSrcFile\0szDstFile\0 indica que szSrcFile se va a cambiar el nombre de szDstFile al reiniciar.
Si un archivo se mueve entre volúmenes, MoveFileTransacted no mueve el descriptor de seguridad con el archivo. Al archivo se le asigna el descriptor de seguridad predeterminado en el directorio de destino.
Esta función siempre produce un error si especifica la marca MOVEFILE_FAIL_IF_NOT_TRACKABLE ; TxF no admite el seguimiento.
En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.
| 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) | No |
| Sistema de archivos resistente a errores (ReFS) | No |
SMB 3.0 no admite TxF.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |