WM_SetEntry

C Specification

#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 the reception of entries, or whether to terminate it.
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 initial state is set by WM_SetParentParameter. Use this function to modify the values.

See Also

WM_SetParentParameter, WM_StartParent

Revision History

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