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