wn_switch_set_state_c
status.i4.v = wn_switch_set_state_c(switch_id.i4.v, switch_state.i4.v,
allow_callbacks.i4.v)
This routine will set the current state of the requested switch.
switch_id ID of desired switch
(returned by prior call to 'wn_switch_create_c')
switch_state desired state
(SWITCH_ON -> turn switch on,
SWITCH_OFF -> turn switch off (latching switches only))
allow_callbacks determine whether or not to allow callback functions
to be called (Note: No callbacks will be executed
if the requested switch state is the same as the
switch's present state.)
(TRUE -> allow callback functions to execute,
FALSE -> inhibit callback functions)
This function returns status values as follows:
CBS_NO_SUCH switch does not exist
CBS_INVTYP requested switch is a momentary switch
otherwise returns the previous value of the switch
This function requires the following include files:
cnsparam_h, cbslib_h, acnet_errors_h
Related functions:
wn_switch_create_c, wn_switch_read_c, wn_switch_pressed,
wn_switch_delete_c, wn_switch_disable_c, wn_switch_enable_c,
wn_switch_relabel_c, switch_set_state_c
C/C++ usage:
int status;
int switch_id;
int switch_state = SWITCH_ON;
int allow_callbacks = TRUE;
status = wn_switch_set_state_c(switch_id,switch_state,allow_callbacks);