Função CopyFileFromAppW (fileapifromapp.h)

Copia um arquivo existente para um novo arquivo. O comportamento dessa função é idêntico ao CopyFile, exceto que essa função adere ao modelo de segurança de aplicativo da Plataforma Universal do Windows.

Sintaxe

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

Parâmetros

lpExistingFileName

O nome de um arquivo existente.

Para obter informações sobre como recusar a limitação de MAX_PATH sem acrescentar "\\?\", consulte a seção "Limitação máxima do comprimento do caminho" de Arquivos de Nomenclatura, Caminhos e Namespaces para obter detalhes.

Se lpExistingFileName não existir, a função falhará e GetLastError retornará ERROR_FILE_NOT_FOUND.

lpNewFileName

O nome do novo arquivo.

Na versão ANSI dessa função, o nome é limitado a MAX_PATH caracteres. Para estender esse limite para 32.767 caracteres de largura, chame a versão Unicode da função e prenda "\\?\" para o caminho. Para obter mais informações, consulte Nomeando um arquivo.

Para a versão unicode dessa função (CopyFileFromAppW), você pode optar por remover a limitação de MAX_PATH sem acrescentar "\\?\". Consulte a seção "Limitação máxima do comprimento do caminho" de Arquivos de Nomenclatura, Caminhos e Namespaces para obter detalhes.

bFailIfExists

Se esse parâmetro for TRUE e o novo arquivo especificado por lpNewFileName já existir, a função falhará. Se esse parâmetro for FALSE e o novo arquivo já existir, a função substituirá o arquivo existente e terá êxito.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Requirements