NANDGetStatusAsync

Syntax

#include <revolution/nand.h>

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

s32 NANDGetStatusAsync( const char *path, NANDStatus *stat, NANDCallback cb, NANDCommandBlock *block );

Arguments

path Specifies the path of the target file or directory.

stat Pointer to a NANDStatus structure.

cb Callback function to call when this function completes processing.

block Command block structure to be passed to the callback function.

path	Specifies the path of the target file or directory.
stat	Pointer to a `NANDStatus` 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 may be returned by NANDGetStatusAsync are listed below. Returns NAND_RESULT_OK when the request begins normally.

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.

NAND_RESULT_OK NAND_RESULT_ACCESS NAND_RESULT_CORRUPT NAND_RESULT_INVALID NAND_RESULT_NOEXISTS NAND_RESULT_UNKNOWN NAND_RESULT_FATAL_ERROR

Description

Obtains the status of the file or directory asynchronously. This requires the appropriate read permission for the parent directory of the file or directory in question. NAND_RESULT_BUSY is returned and this function call is denied when the queue for accepting requests inside the library is full.

Revision History

2008/08/01 Revised the result codes that are passed to the callback function.
2008/05/13 Described the result codes passed to the callback function.
2006/11/30 Added a mention of the need to have read permission for the parent directory.
2006/06/16 Initial version.