# MB_RegisterFile

## C Specification

  `#include <nitro/mb.h>`
  `BOOL MB_RegisterFile(const MBGameRegistry *game_reg, const void *buf);`

## Arguments

game_reg | Pointer to the `MBGameRegistry` structure where the program information to register is saved.
buf | Pointer to the memory where the extracted segment is saved. Get the segment data with the `MB_ReadSegment` function. When the function succeeds, the memory specified here is used internally until the `MB_UnregisterFile` function is called.

## Return Values

This function returns `TRUE` when the program registers correctly. Otherwise, it returns `FALSE`.

## Description

This function registers the specified program file on the download program list. The parent can simultaneously download game programs up to `MB_MAX_FILE`. The specified segment data must be obtained by calling `MB_ReadSegment` before calling this function. When calling this function using segment data that is set for dynamic reading from an archive, note that the MB library will internally start a single thread automatically. For details, see the "Internal Operation" section of the `MB_ReadSegment` function.

## See Also

`MBGameRegistry, MB_GetSegmentLength, MB_ReadSegment, MB_UnregisterFile`

## Revision History

04/11/2005 Added warning about task thread and link.
09/09/2004 Added description regarding the `MB_UnregisterFile` function.
08/09/2004 Initial version.