Función CopyFileFromAppW (fileapifromapp.h)

Copia un archivo existente en un archivo nuevo. El comportamiento de esta función es idéntico a CopyFile, salvo que esta función se adhiere al modelo de seguridad de aplicaciones Plataforma universal de Windows.

Sintaxis

WINSTORAGEAPI BOOL CopyFileFromAppW(
  LPCWSTR lpExistingFileName,
  LPCWSTR lpNewFileName,
  BOOL    bFailIfExists
) noexcept;

Parámetros

lpExistingFileName

Nombre de un archivo existente.

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.

Si lpExistingFileName no existe, se produce un error en la función y GetLastError devuelve ERROR_FILE_NOT_FOUND.

lpNewFileName

Nombre del nuevo archivo.

En la versión ANSI de esta función, el nombre se limita a MAX_PATH caracteres. Para ampliar este límite a 32 767 caracteres anchos, llame a la versión Unicode de la función y anteponga "\\?\" a la ruta de acceso. Para obtener más información, vea Asignación de nombre de un archivo.

Para la versión unicode de esta función (CopyFileFromAppW), 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.

bFailIfExists

Si este parámetro es TRUE y el nuevo archivo especificado por lpNewFileName ya existe, se produce un error en la función. Si este parámetro es FALSE y el nuevo archivo ya existe, la función sobrescribe el archivo existente y se realiza correctamente.

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.

Requisitos

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