Função CopyFileFromAppW (fileapifromapp.h)

  • Artigo

Copia um arquivo existente para um novo arquivo. O comportamento dessa função é idêntico ao CopyFile, exceto pelo fato de que essa função segue o modelo de segurança do aplicativo 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 largos, chame a versão Unicode da função e acrescente "\\?\" ao caminho. Para obter mais informações, confira Como nomear 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 retornado

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

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

Requisitos

   
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho fileapifromapp.h