Funzione CopyFileFromAppW (fileapifromapp.h)

Copia un file esistente in un nuovo file. Il comportamento di questa funzione è identico a CopyFile, ad eccezione del fatto che questa funzione rispetta il modello di sicurezza delle app piattaforma UWP (Universal Windows Platform).

Sintassi

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

Parametri

lpExistingFileName

Nome di un file esistente.

Per informazioni su come rifiutare esplicitamente la limitazione MAX_PATH senza anteporre "\\?\", vedere la sezione "Limitazione massima della lunghezza del percorso" di Denominazione di file, percorsi e spazi dei nomi per informazioni dettagliate.

Se lpExistingFileName non esiste, la funzione ha esito negativo e GetLastError restituisce ERROR_FILE_NOT_FOUND.

lpNewFileName

Nome del nuovo file.

Nella versione ANSI di questa funzione il nome è limitato a MAX_PATH caratteri. Per estendere questo limite a 32.767 caratteri wide, chiamare la versione Unicode della funzione e anteporre "\\?\" al percorso. Per altre informazioni, vedere Denominazione di un file.

Per la versione Unicode di questa funzione (CopyFileFromAppW), è possibile acconsentire esplicitamente per rimuovere la limitazione MAX_PATH senza anteporre "\?\". Per informazioni dettagliate, vedere la sezione "Limitazione massima della lunghezza del percorso" di Denominazione di file, percorsi e spazi dei nomi .

bFailIfExists

Se questo parametro è TRUE e il nuovo file specificato da lpNewFileName esiste già, la funzione ha esito negativo. Se questo parametro è FALSE e il nuovo file esiste già, la funzione sovrascrive il file esistente e ha esito positivo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti