# WM_StartParent

## C Specification

      #include <nitro/wm.h>

      WMErrCode WM_StartParent( WMCallbackFunc callback );

## Description

Starts a parent operation based on parameters set by `WM_SetParentParameter`

This function is only executable when the WM is in the `IDLE` state. This function changes the WM to the `PARENT` state.

If the return value is `WM_ERRCODE_OPERATING`, a callback is generated after the setup process to be a parent is completed.

If the current number of connected children is less than the number specified by `maxEntry(WM_SetParentParameter)`, it accepts children and generates a callback when a connection is completed. One callback can only obtain information for one child machine.

If the beacon transmission indicator is enabled by `WM_SetBeaconIndication`, the specified callback is generated every time the beacon is transmitted.

## Arguments

`callback` | Callback function to call when an asynchronous process completes.

## Return Values

Returns the process result as a `WMErrCode` enumerated type.

## See Also

`WM_SetParentParameter`, `WM_EndParent`

## Revision History

10/22/2004 Changed return value type
08/02/2004 Standardized structure name
07/23/2004 Added descriptions
07/23/2004 Initial Version