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.

[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.

[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
MOVEFILE_COPY_ALLOWED 2 (0x2)	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.
MOVEFILE_CREATE_HARDLINK 16 (0x10)	Reservado para uso futuro.
MOVEFILE_DELAY_UNTIL_REBOOT 4 (0x4)	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.
MOVEFILE_REPLACE_EXISTING 1 (0x1)	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.
MOVEFILE_WRITE_THROUGH 8 (0x8)	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.

El sistema usa estas entradas del Registro para completar las operaciones al reiniciarse en el mismo orden en que se emitieron. Para obtener más información sobre el uso de la marca de MOVEFILE_DELAY_UNTIL_REBOOT , vea MoveFileWithProgress.

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

Vea también

CopyFileTransacted

Funciones de administración de archivos

MoveFileWithProgress

NTFS de transacciones