set_bit_mask_strings_c

	status.i4.v = set_bit_mask_strings_c(num_values.i4.v,
					     bit_numbers.u4a.r,
					     text.i1a.r,
					     entry_length.i4.v
					     text_if_0.i1a.r,
					     entry_len_if_0.i4.v,
					     text_if_1.i1a.r,
					     entry_len_if_1.i4.v,
					     help_info.sa.r,
					     bit_mask_id.i4.r)

	This routine sets up the text strings associated with the
	bit mask data type used by the numeric_to_ascii(_c),
	ascii_to_numeric(_c), '(window_)display_value(_c)',
	'(window_)input_value(_c)', and winput(_c) routines.  The
	present values for these strings can be read by a call to
	'get_bit_mask_strings'.  The status strings for whether or
	not each bit is set are optional and can be defaulted with
	a value of NULL.

	num_values	number of bit mask entries
	bit_numbers	bit number values (bit numbering starts at 1)
	text		bit mask text strings
	entry_length	number of characters per bit mask text entry
	text_if_0	bit mask text strings indicating status
			if the corresponding bit is clear
	entry_len_if_0	number of characters per entry for the
			status text if the corresponding bit is clear
	text_if_1	bit mask text strings indicating status
			if the corresponding bit is set
	entry_len_if_1	number of characters per entry for the
			status text if the corresponding bit is set
	help_info	entry by entry help callback information
			(array of HELP_CALLBACK_DATA structures)
			(A value of NULL can be passed for this argument,
			 if no context sensitive entry help is desired.)
	bit_mask_id	If this argument has a value other than NULL,
			an identification number will be returned which
			can be used for referring to this set of bit mask
			values in future calls to 'get_bit_mask_strings',
			numeric_to_ascii(_c), ascii_to_numeric(_c),
			and any of the routines that call them.

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid number of values or entry length
	CBS_MEMFAIL		dynamic memory allocation failure
	CBS_INVSIZ		all passed strings are null strings

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	get_bit_mask_strings_c, get_enumerated_strings,
	modify_enumerated_strings_c, ascii_to_numeric(_c),
	numeric_to_ascii(_c), get_logical_strings,
	set_logical_strings, create_user_data_type_c,
	window_display_value(_c), window_input_value(_c), winput(_c)

	C/C++ usage:

	static char	text[NUM_VALUES][ENTRY_LENGTH+1] = {"string1", "string2"};
	char	*text_if_0 = (char *) NULL;
	char	*text_if_1 = (char *) NULL;
	int	status;
	int	num_values = NUM_VALUES;
	int	entry_length = ENTRY_LENGTH + 1;
	int	entry_len_if_0 = 0;
	int	entry_len_if_1 = 0;
	int	bit_mask_id;
	unsigned int	bit_numbers[NUM_VALUES] = {0, 1};
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	status = set_bit_mask_strings_c(num_values,bit_numbers,
					(char *) text,entry_length,
					text_if_0,entry_len_if_0,
					text_if_1,entry_len_if_1,
					help_info,&bit_mask_id);