# CARDResult

## Definition

  `#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,
  CARD_RESULT_NO_RESPONSE,
  CARD_RESULT_CANCELED
  } CARDResult;
  `

## Description

The enumerator constant showing the results of the function process that accesses the CARD ROM device and the backup device. The meaning of each enumerator constant is shown in the following table:

Constant | Description
`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 loaded device has reached the end of its lifespan or 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_NO_RESPONSE | Process failed because the loaded device did not even reply about its status. This may occur because of poor contact between the NITRO-CARD and the DS system or because the loaded device failed.
CARD_RESULT_CANCELED | Indicates that a function process with a wait time was stopped by the CARD_CancelBackupAsync function.
`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 CARD_CancelBackupAsync`

## Revision History

09/02/2005 Added CARD_RESULT_NO_RESPONSE and CARD_RESULT_CANCELED.
04/05/2005 Added text about card contact problem to description of CARD_RESULT_TIMEOUT.
08/23/2004 Added description of retry in library.
07/28/2004 Initial version.

CONFIDENTIAL