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 de la Plataforma universal de Windows.

Syntax

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 tener que esperar "\\?\", 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.

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 Asignar nombre a un archivo.

Para la versión unicode de esta función (CopyFileFromAppW), puede optar por quitar el MAX_PATH limitación sin prepending "\\?\". Consulte la sección "Limitación máxima de longitud de ruta de acceso" de nomenclatura 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 ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos