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