# MB_FakeStartScanParent

## C Specification

      #include <nitro/mb/mb_fake_child.h>

      void MB_FakeStartScanParent( MBFakeScanCallbackFunc callback, u32 ggid );

## Description

This function scans for a multiboot parent. If a multiboot parent is discovered with a GGID that matches the ggid argument, the discovery is announced by the callback. The search for multiboot parents that match the specified GGID continues across all usable channels until `MB_FakeEndScan` is called.

When a parent is discovered, the function returns `MB_FAKESCAN_PARENT_FOUND` in the callback. When a parent is lost, the callback returns `MB_FAKESCAN_PARENT_LOST`. If a communication error occurs, the function returns `MB_FAKESCAN_API_ERROR`.

## Arguments

`callback` | Specifies the callback function for announcing when parents are discovered and lost.
`ggid` | Specifies a 4-byte game group ID. Only parents with the specified ggid are discovered.

## Return Values

None.

## See Also

`MB_FakeEndScan, MBFakeScanCallbackFunc`

## Revision History

11/25/2004 Initial version.