switch_text_to_id_c

	status.i4.v = switch_text_to_id_c(search_window.i2.v, text.i1a.r,
					  text_type.i4.v, switch_id.i4.r)

	This routine returns the ID a switch having given handle or
	label string.  A value of NULL can be passed for returned
	ID argument.

	search_window	window ID to search
			(WMNGR_ALL_WINDOWS -> search all windows,
			 otherwise -> search specific window)
	text		null terminated ASCII string whose interpretation
			depends on "text_type"
	text_type	type of text to match
			(SWITCH_BY_HANDLE -> match text string to the
					     switch handle,
			 SWITCH_BY_LABEL -> match text string to the
					    switch label)
			(These values can be ORed together to make a
			 combined search.)
	switch_id	returned switch ID

	This function returns ACNET status values as follows:

	OK			success
	CBS_DUPREQ		multiple matches were found
				(data for the first match is returned)
	CBS_NO_SUCH		switch doesn't exist

	This function requires the following include files:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	switch_create_c, switch_create_radio_c, switch_delete_c,
	switch_window_delete_c, switch_set_flash_c, switch_read_c,
	switch_pressed, switch_relabel_c, switch_change_case_c,
	switch_enable_c, switch_disable_c, switch_set_state_c

	C/C++ usage:

	static const char	text[] = "matching text";
	short	search_window = WMNGR_ALL_WINDOWS;
	int	status;
	int	text_type = SWITCH_BY_HANDLE;
	int	switch_id;

	status = switch_text_to_id_c(search_window,text,text_type,&switch_id);