nn::fs::FileStream::TryInitialize Member Function

Syntax

nn::Result TryInitialize(
     const wchar_t * pathName,
     bit32 openMode
);

nn::Result TryInitialize(
     const char * pathName,
     bit32 openMode
);

List of Overloaded Member Functions

TryInitialize(const wchar_t *, bit32) Opens the specified file.
TryInitialize(const char *, bit32) Opens the specified file.

Description of TryInitialize(const wchar_t *, bit32)

Opens the file at the specified path in the specified openMode. If no file exists at the specified path, this function creates a file and opens it in write-only mode. You cannot call this function if you have already opened a file using this object. For details on the openMode argument, see OpenMode.

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

Important

For expanded save data, you must explicitly create a file using the nn::fs::TryCreateFile function before calling this function. Note: Specifying OPEN_MODE_CREATE for openMode when using expanded save data will cause an error. See Archives for details about expanded save data.

Description of TryInitialize(const char *, bit32)

Opens the file at the specified path in the specified openMode. If no file exists at the specified path, this function creates a file and opens it in write-only mode. This function returns any error that occurs while it is opening the file. For details on the openMode argument, see OpenMode.


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.

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

Important

For expanded save data, you must explicitly create a file using the nn::fs::TryCreateFile function before calling this function. Note: Specifying OPEN_MODE_CREATE for openMode when using expanded save data will cause an error. See Archives for details about expanded save data.

CONFIDENTIAL