CopyFileFromAppW 関数 (fileapifromapp.h)

既存のファイルを新しいファイルにコピーします。 この関数の動作は CopyFile と同じですが、この関数はユニバーサル Windows プラットフォームアプリ セキュリティ モデルに準拠しています。

構文

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

パラメーター

lpExistingFileName

既存のファイルの名前。

前もって "\\?\" を指定せずに MAX_PATH 制限からオプトアウトする方法の詳細については、「ファイル、パス 、および名前空間の名前付け 」の「パスの最大長の制限」セクションを参照してください。

lpExistingFileName が存在しない場合、関数は失敗し、GetLastError はERROR_FILE_NOT_FOUNDを返します。

lpNewFileName

新しいファイルの名前。

この関数の ANSI バージョンでは、名前は MAX_PATH 文字に制限されています。 この制限を 32,767 文字のワイド文字に拡張するには、Unicode バージョンの 関数を呼び出し、パスの先頭に "\\?\" を付加します。 詳細については、ファイルの名前つけに関する記事を参照してください。

この関数の Unicode バージョン (CopyFileFromAppW) の場合は、"\\?\" を前もって指定せずに 、MAX_PATH の制限を削除するようにオプトインできます。 詳細については、「 ファイル、パス、および名前空間の名前付け 」の「最大パス長の制限」セクションを参照してください。

bFailIfExists

このパラメーターが TRUE で、 lpNewFileName で指定された新しいファイルが既に存在する場合、関数は失敗します。 このパラメーターが FALSE で、新しいファイルが既に存在する場合、関数は既存のファイルを上書きして成功します。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

サポートされている最小のクライアント	Windows 10 バージョン 1803
Header	fileapifromapp.h