# WM_SetEntry

## C Specification

      #include <nitro/wm.h>

      WMErrCode WM_SetEntry(
              WMCallbackFunc  callback ,
              BOOL            enabled );

## 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.

## Arguments

`callback` | Designates the callback function that is called when the asynchronous processing is complete.
`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 process result as a `WMErrCode` enumerated type.

## See Also

`WM_SetParentParameter`, `WM_StartParent`

## Revision History

10/22/2004 Changed return value types
08/20/2004 Initial version