nn::fs::TryCreateFile Function

Syntax

Result TryCreateFile(
     const wchar_t * pathName,
     s64 size
);
Result TryCreateFile(
     const char * pathName,
     s64 size
);

List of Overloaded Member Functions

TryCreateFile(const wchar_t *, s64) Creates a file.
TryCreateFile(const char *, s64) Creates a file.

Description of TryCreateFile(const wchar_t *, s64)

This function returns any error that occurs while it is creating the file.

If file creation fails, a garbage file may have been created. Call the TryDeleteFile function to delete it. If a garbage file has not been created, ResultNotFound is returned.

Which Result values need handling will differ, depending on the archive. For details, see Handling Errors During File and Directory Operations.

Note

After a file has been created with this function, if nothing has been written then in principle the process of reading will return nn::fs::ResultVerificationFailed.

Description of TryCreateFile(const char *, s64)

This function returns any error that occurs while it is creating the file.


Note: This function uses a large amount of buffer space on the stack because it converts the path name from a multibyte string into a wide string. Pay careful attention to the stack size.

If file creation fails, a garbage file may have been created. Call the TryDeleteFile function to delete it. If a garbage file has not been created, ResultNotFound is returned.

Which Result values need handling will differ, depending on the archive. For details, see Handling Errors During File and Directory Operations.

Note

After a file has been created with this function, if nothing has been written then in principle the process of reading will return nn::fs::ResultVerificationFailed.


CONFIDENTIAL