CopyFileFromAppW-Funktion (fileapifromapp.h)

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

Syntax

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

Die Parameter

lpExistingFileName

Der Name einer vorhandenen Datei.

Weitere Informationen zum Deaktivieren der MAX_PATH Einschränkung ohne voranstehende "\\?\", finden Sie im Abschnitt "Maximale Pfadlängenbeschränkung" der Benennungsdateien, Pfade 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 breite Zeichen 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 "\\?\". Weitere Informationen finden Sie im Abschnitt "Maximale Pfadlängenbeschränkung" der Benennungsdateien, Pfade und Namespaces .

bFailIfExists

Wenn dieser Parameter TRUE ist und die durch 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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Anforderungen