# 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