Función ReplaceFileFromAppW (fileapifromapp.h)

Artículo
03/09/2023

Reemplaza un archivo por otro, con la opción de crear una copia de seguridad del archivo original. El comportamiento de esta función es idéntico a ReplaceFile, salvo que esta función se adhiere al modelo de seguridad de aplicaciones Plataforma universal de Windows.

Sintaxis

WINSTORAGEAPI BOOL ReplaceFileFromAppW(
  LPCWSTR lpReplacedFileName,
  LPCWSTR lpReplacementFileName,
  LPCWSTR lpBackupFileName,
  DWORD   dwReplaceFlags,
  LPVOID  lpExclude,
  LPVOID  lpReserved
) noexcept;

Parámetros

lpReplacedFileName

Para obtener información sobre cómo no participar en la limitación de MAX_PATH sin prepending "\\?\\ ", vea 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.

Este archivo se abre con los derechos de acceso GENERIC_READ, DELETE y SYNCHRONIZE . El modo de uso compartido se FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE.

El autor de la llamada debe tener acceso de escritura al archivo que se va a reemplazar. Para obtener más información, vea Seguridad de archivos y derechos de acceso.

lpReplacementFileName

Nombre del archivo que reemplazará el archivo lpReplacedFileName .

La función intenta abrir este archivo con los derechos de acceso SYNCHRONIZE, GENERIC_READ, GENERIC_WRITE, DELETE y WRITE_DAC para que pueda conservar todos los atributos y ACL. Si se produce un error, la función intenta abrir el archivo con los derechos de acceso SYNCHRONIZE, GENERIC_READ, DELETE y WRITE_DAC . No se especifica ningún modo de uso compartido.

lpBackupFileName

Nombre del archivo que servirá como copia de seguridad del archivo lpReplacedFileName . Si este parámetro es NULL, no se crea ningún archivo de copia de seguridad. Consulte la sección Comentarios para obtener detalles de implementación sobre el archivo de copia de seguridad.

dwReplaceFlags

Opciones de reemplazo. Este parámetro puede ser uno o más de los siguientes valores.

Valor	Significado
REPLACEFILE_WRITE_THROUGH 0x00000001	Este valor no se admite.
REPLACEFILE_IGNORE_MERGE_ERRORS 0x00000002	Omite los errores que se producen al combinar información (como atributos y ACL) del archivo reemplazado al archivo de reemplazo. Por lo tanto, si especifica esta marca y no tiene WRITE_DAC acceso, la función se realiza correctamente, pero las ACL no se conservan.
REPLACEFILE_IGNORE_ACL_ERRORS 0x00000004	Omite los errores que se producen al combinar la información de ACL del archivo reemplazado al archivo de reemplazo. Por lo tanto, si especifica esta marca y no tiene WRITE_DAC acceso, la función se realiza correctamente, pero las ACL no se conservan. Para compilar una aplicación que use este valor, defina la macro _WIN32_WINNT como 0x0600 o posterior.

lpExclude

Reservado para un uso futuro.

lpReserved

Reservado para un uso futuro.

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. Los siguientes son posibles códigos de error para esta función.

Código o valor devuelto	Descripción
ERROR_UNABLE_TO_MOVE_REPLACEMENT 1176 (0x498)	No se pudo cambiar el nombre del archivo de reemplazo. Si se especificó lpBackupFileName , los archivos reemplazados y de reemplazo conservan sus nombres de archivo originales. De lo contrario, el archivo reemplazado ya no existe y el archivo de reemplazo existe bajo su nombre original.
ERROR_UNABLE_TO_MOVE_REPLACEMENT_2 1177 (0x499)	No se pudo mover el archivo de reemplazo. El archivo de reemplazo sigue existiendo bajo su nombre original; sin embargo, ha heredado los flujos de archivos y atributos del archivo que está reemplazando. El archivo que se va a reemplazar sigue existiendo con un nombre diferente. Si se especifica lpBackupFileName , será el nombre del archivo reemplazado.
ERROR_UNABLE_TO_REMOVE_REPLACED 1175 (0x497)	No se pudo eliminar el archivo reemplazado. Los archivos reemplazados y de reemplazo conservan sus nombres de archivo originales.

Si se devuelve cualquier otro error, como ERROR_INVALID_PARAMETER, los archivos reemplazados y de reemplazo conservarán sus nombres de archivo originales. En este escenario, no existe un archivo de copia de seguridad y no se garantiza que el archivo de reemplazo haya heredado todos los atributos y secuencias del archivo reemplazado.

Requisitos


Cliente mínimo compatible	Windows 10, versión 1803
Encabezado	fileapifromapp.h

Share via