NANDSimpleSafeCloseAsync

Syntax

#include <revolution/nand.h>

typedef void (*NANDCallback)( s32 result, NANDCommandBlock *block );

s32 NANDSimpleSafeCancelAsync( NANDFileInfo *info, NANDCallback cb, NANDCommandBlock *block );

Arguments

info Pointer to a NANDFileInfo structure
cb Callback function to call when this function completes processing.
block Command block structure to be passed to the callback function.

Return Values

The result codes that NANDSimpleSafeCancelAsync can return are listed below. When the request begins normally, returns NAND_RESULT_OK.

NAND_RESULT_OK
NAND_RESULT_ACCESS
NAND_RESULT_ALLOC_FAILED
NAND_RESULT_BUSY
NAND_RESULT_INVALID
NAND_RESULT_FATAL_ERROR

The result codes that may be passed to the callback function are listed below. If the resource is deallocated normally, NAND_RESULT_OK is passed to the specified callback function.

NAND_RESULT_OK
NAND_RESULT_ALLOC_FAILED
NAND_RESULT_BUSY
NAND_RESULT_CORRUPT
NAND_RESULT_INVALID
NAND_RESULT_UNKNOWN
NAND_RESULT_FATAL_ERROR

Description

This (asynchronous) function will try to deallocate the resources (temporary files and file descriptors) that were used by the NANDSimpleSafe-related functions. Call this function when any NANDSimpleSafe-type related function (excluding NANDSimpleSafeCancel[Async]) ends on a NAND_RESULT_AUTHENTICATION or NAND_RESULT_CRIT error, or when a NAND_RESULT_AUTHENTICATION or NAND_RESULT_ECC_CRIT error occurs when reading or writing a file that was opened by a NANDSimpleSafe-type function. For more information, see Error Processing When Using NANDSimpleSafe-related Functions. When NANDSimpleSafeCancelAsync returns an error, process the error in accordance with Error Processing After Starting Application.

It is not necessary to apply NANDSimpleSafeClose[Async] to the NANDFileInfo structure passed to this function.

The callback function specified with this function may receive NAND_RESULT_ALLOC_FAILED or NAND_RESULT_BUSY.

This function updates the FAT of Wii console NAND memory. However, the FAT will not be updated if this is run when NANDSimpleSafe-type functions have not returned an error.

See Also

NANDSimpleSafeCancel, NANDSimpleSafeOpen, NANDSimpleSafeOpenAsync, NANDSimpleSafeClose, NANDSimpleSafeCloseAsync

Revision History

2008/08/01 Added an explanation related to FAT updates.
2008/05/26 Revised the conditions for calling this function in Description.
2008/05/13 Added description of the result codes passed to the callback function.
2007/05/09 Initial version.


CONFIDENTIAL