# 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:

Value | Description
`CARD_RESULT_SUCCESS` | Indicates the function process completed successfully. This indicates a logical return value of `TRUE` that can be obtained from functions such as `CARD_Verify*`.
`CARD_RESULT_FAILURE` | Indicates the function process was inside the expected range and failed. This indicates a logical return value of `FALSE` that can be obtained from functions such as `CARD_Verify*`.
`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 the function used a feature not supported by the device specified in the `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 the `CARD_CancelBackupAsync` function was used to stop processing a function that has a wait time.
`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

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

CONFIDENTIAL