SAVEChangeGroupMode / SAVEChangeGroupModeAsync

Syntax

#include <nn/save.h>

FSStatus            SAVEChangeGroupMode(
                        FSClient                *client,
                        FSCmdBlock              *block,
                        u8                      accountSlotNo,
                        const char              *path,
                        FSMode                  mode,
                        FSRetFlag               errHandling
                        );
FSStatus            SAVEChangeGroupModeAsync(
                        FSClient                *client,
                        FSCmdBlock              *block,
                        u8                      accountSlotNo,
                        const char              *path,
                        FSMode                  mode,
                        FSRetFlag               errHandling,
                        const FSAsyncParams     *asyncParams
                        );

Parameters

client Pointer to the client buffer.
block Command block.
accountSlotNo The user account slot number.
path The file path. The relative path for the save directory for the specified user account. The length must be less than SAVE_MAX_ARGPATH_SIZE.
mode Permissions to set. Multiple options can be selected using bitwise OR.
If no read/write permission is specified, permission is canceled.
FS_MODE_IRGRP: Adds read permission for the Group.
FS_MODE_IWGRP: Adds write permission for the Group.
FS_MODE_IRWG: Adds read and write permission for the Group.
errHandling Automatic error handling flag. Only the indicated error is returned.
asyncParams (Async API only) Notification parameters for an asynchronous call.

Return Values

Synchronous API: Return Value; Asynchronous API: Callback Return Value

FS_STATUS_OK Successfully completed.
FS_STATUS_CANCELED The command was canceled.
FS_STATUS_NOT_FOUND Target not found.
or
The specified user account does not exist on this Wii U console.
FS_STATUS_PERMISSION_ERROR The caller does not have the correct access permission.
FS_STATUS_UNSUPPORTED_CMD Associated file system does not support this function.
FS_STATUS_JOURNAL_FULL Journaling space is full and new journaling block cannot be allocated.
FS_STATUS_MEDIA_NOT_READY (Only for manually mounted devices) Media is not present.
FS_STATUS_MEDIA_ERROR (Only for manually mounted devices) Media is in some inaccessible condition.
FS_STATUS_DATA_CORRUPTED (Only for manually mounted devices) The data is corrupted beyond repair. The volume needs format.
FS_STATUS_FATAL_ERROR The argument is invalid.

Async API: Immediate Return Values

FS_STATUS_OK Successfully issued the request.
FS_STATUS_NOT_FOUND The specified user account does not exist on this Wii U console.
FS_STATUS_FATAL_ERROR The argument is invalid.

Description

Changes the Group permissions specified for a file.

Attempts to change permissions other than those for Group (such as Owner and Others) are ignored; those permissions are not changed. If you try to change Group and other permissions at the same time, only the Group permissions are changed; no other permissions are changed.

Because of the PCFS specifications, correct permission changes cannot be made for PCFS save directories. Accordingly, this API always provides read and write permissions to all Owner, Group, and Others within PCFS save directories. Correct permission changes can be made for NAND save directories.

Do Not Call From

SAVEChangeGroupMode

None.

SAVEChangeGroupModeAsync

None.

Revision History

2014/10/22 Revised the return values.
2013/05/08 Automated cleanup pass.
2012/10/01 Revised the return values.
2012/06/26 Initial version.


CONFIDENTIAL