##### Shinobi Library - Memory Card Function

# buFindExecFile

Gets the name of an executable file

### FORMAT

`

  Sint32 buFindExecFile( drive, *fname )
  Sint32 drive
  char *fname

`

### PARAMETER

  `drive` | Extension socket number
  `fname` | File name

### RETURN

  BUD_ERR_OK | Normal end |
  BUD_ERR_FILE_NOT_FOUND | Executable file not found |
  BUD_ERR_UNFORMAT | Disk is not formatted |
  BUD_ERR_NO_DISK | Memory card not found |
  BUD_ERR_BUSY | A TYPE_B function was being processed |

### DESCRIPTION

  Gets the name of an executable file.

  The following values can be designated for the argument `drive` that specifies extension sockets.

  BUD_DRIVE_A1 | Extension socket 1 on board A
  BUD_DRIVE_A2 | Extension socket 2 on board A
  BUD_DRIVE_B1 | Extension socket 1 on board B
  BUD_DRIVE_B2 | Extension socket 2 on board B
  BUD_DRIVE_C1 | Extension socket 1 on board C
  BUD_DRIVE_C2 | Extension socket 2 on board C
  BUD_DRIVE_D1 | Extension socket 1 on board D
  BUD_DRIVE_D2 | Extension socket 2 on board D

### EXAMPLE

      A minimum of 13 bytes is required for the area where the file name is to be stored.
      If the file does not exist, then fname[0] = '\0' results.
      This function is completely independent of the buFindFirstFile() and buFindNextFile()
      functions, and can be used without affecting the operation of either of those functions.

        Sint32 ret;
        char fname[16];
        /* Get name of executable file */
        ret = buFindExecFile(BUD_DRIVE_A1, fname);
        switch (ret) {
        case BUD_ERR_OK:
          /* Executable file found. The file name is stored in fname. */
          printf("Executable file: %s\n", fname);
          break;
        case BUD_ERR_FILE_NOT_FOUND:
          printf("Executable file not found. \n");
          break;
        default:
          printf("Error \n");
          break;
        }

buFindExecFile

COPYRIGHT © SEGA ENTERPRISES, LTD., 1998,1999