WM_SetEntry

Syntax

#include <nitro/wm.h>

WMErrCode WM_SetEntry( WMCallbackFunc  callback , BOOL enabled );

Arguments

callback Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler.
enabled Designates whether to permit or deny (terminate) the reception of entries.
A value of TRUE indicates the permission to receive. A value of FALSE indicates that reception is not allowed (it has been terminated).

Return Values

Returns the results of the WMErrCode enumerated type process.

Description

Changes the parent device's entry reception state for transmissions from the child device. If the state change is prohibited, all subsequent connections requests from the child device will be denied. If the state change is permitted, connections will be accepted from child devices as long as the maximum number of connected child devices is not exceeded. This function can be executed only if the WM is in the PARENT or MP_PARENT state. If the return value is WM_ERRCODE_OPERATING, a callback will occur after the changes to the entry reception state have completed. The WM_SetParentParameter function sets the initial state, and this function modifies the values.

See Also

WM_SetParentParameter, WM_StartParent

Revision History

2005/06/08 Added statement about callbacks being called from the interrupt handler.
2004/10/22 Changed return value type.
2004/08/20 Initial version.


CONFIDENTIAL