CopyFileFromAppW-Funktion (fileapifromapp.h)

Kopiert eine vorhandene Datei in eine neue Datei. Das Verhalten dieser Funktion ist mit CopyFile identisch, mit der Ausnahme, dass diese Funktion dem Universelle Windows-Plattform App-Sicherheitsmodell entspricht.

Syntax

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

Parameter

lpExistingFileName

Der Name einer vorhandenen Datei.

Weitere Informationen zum Deaktivieren der MAX_PATH Einschränkung ohne voranschreiten von "\\?\", finden Sie im Abschnitt "Beschränkung der maximalen Pfadlänge" unter Benennen von Dateien, Pfaden und Namespaces .

Wenn lpExistingFileName nicht vorhanden ist, schlägt die Funktion fehl, und GetLastError gibt ERROR_FILE_NOT_FOUND zurück.

lpNewFileName

Der Name der neuen Datei.

In der ANSI-Version dieser Funktion ist der Name auf MAX_PATH Zeichen beschränkt. Um diesen Grenzwert auf 32.767 Breitzeichen zu erweitern, rufen Sie die Unicode-Version der Funktion auf, und stellen Sie dem Pfad "\\?\" voran. Weitere Informationen finden Sie unter Benennen einer Datei.

Für die Unicode-Version dieser Funktion (CopyFileFromAppW) können Sie die MAX_PATH-Einschränkung entfernen, ohne "\\?\" vorab auszuschreiben. Ausführliche Informationen finden Sie im Abschnitt "Maximale Längenbeschränkung für Pfade" unter Benennen von Dateien, Pfaden und Namespaces .

bFailIfExists

Wenn dieser Parameter TRUE ist und die von lpNewFileName angegebene neue Datei bereits vorhanden ist, schlägt die Funktion fehl. Wenn dieser Parameter FALSE ist und die neue Datei bereits vorhanden ist, überschreibt die Funktion die vorhandene Datei und ist erfolgreich.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	fileapifromapp.h