# CARDResult

## C Specification

      #include <nitro/card.h>

      typedef	enum {
        CARD_RESULT_SUCCESS = 0,
        CARD_RESULT_FAILURE,
        CARD_RESULT_INVALID_PARAM,
        CARD_RESULT_UNSUPPORTED,
        CARD_RESULT_TIMEOUT,
        CARD_RESULT_ERROR
      } CARDResult;

## Description

The enumerator constant showing the results of the function process that accesses the CARD ROM device and the backup device.

## Constants

The meaning of each constant is as follows.

Constant | Meaning
`CARD_RESULT_SUCCESS` | Indicates the function process completed successfully. As with the `CARD_VerifyBackup` function, this returns `TRUE` when the process results are obtainable with a truth value.
`CARD_RESULT_FAILURE` | Indicates the function process was inside the expected range and failed. As with the `CARD_VerifyBackup` function, this returns `FALSE` when the process results are obtainable with a truth value.
`CARD_RESULT_INVALID_PARAM` | Indicates that the process failed due to a problem wih the argument passed to the function.
`CARD_RESULT_UNSUPPORTED` | Indicates the process failed because a function used a feature not loaded in the device specified in the current `CARD_IdentifyBackup` function. This occurs when the device type is not specified or when `CARD_BACKUP_TYPE_NOT_USE` is indicated.
`CARD_RESULT_TIMEOUT` | Indicates that a function with a wait time exceeded the prescribed time and was stopped. This may occur because the device failed. Note: The functions that require a wait time generate their own retries. Therefore, the game application does not need to generate additional retries after receiving the return value.
`CARD_RESULT_ERROR` | Indicates the process failed because of a problem other than those listed above.

## See Also

`CARD_IdentifyBackup, CARD_GetResultCode, CARD_ReadRom, CARD_ReadEeprom, CARD_WriteEeprom, CARD_VerifyEeprom, CARD_WriteAndVerifyEeprom`

## Revision History

08/23/2004 Added a description of function-generated retries to `CARD_RESULT_TIMEOUT`.
07/28/2004 Initial version.