get_bit_mask_strings_c

	status.i4.v = get_bit_mask_strings_c(num_values.i4.r,
					     bit_numbers.u4p.r,
					     text.i1p.r,
					     entry_length.i4.r
					     text_if_0.i1p.r,
					     entry_len_if_0.i4.r,
					     text_if_1.i1p.r,
					     entry_len_if_1.i4.r,
					     help_info.sp.r,
					     bit_mask_id.u4.v)

	This routine returns the text strings associated with any
	bit mask data type used by the numeric_to_ascii(_c),
	ascii_to_numeric(_c), '(window_)display_value(_c)', and
	'(window_)input_value(_c)' routines.  The values for these
	strings must have been set by a prior call to
	set_bit_mask_strings_c.  Since the memory to hold these
	strings is allocated by this routine, the calling program
	should free this memory when it is done using the strings.
	If any of the returned parameters are not desired, a value
	of NULL can be passed for the corresponding argument.

	num_values	returned number of bit mask entries
	bit_numbers	returned array of bit mask bit numbers
			(bit numbering starts at 1)
	text		returned bit mask text strings
	entry_length	returned number of characters per bit mask text entry
	text_if_0	returned bit mask text strings indicating status
			if the corresponding bit is clear
	entry_len_if_0	returned number of characters per entry for the
			status text if the corresponding bit is clear
	text_if_1	returned bit mask text strings indicating status
			if the corresponding bit is set
	entry_len_if_1	returned number of characters per entry for the
			status text if the corresponding bit is set
	help_info	returned entry by entry help callback information
			(pointer to an array of HELP_CALLBACK_DATA structures)
	bit_mask_id	identification number returned from prior call
			to set_bit_mask_strings_c (A value of 0 will
			result in the return of the default bit mask set.)

	This function returns ACNET status values as follows:

	OK			success
	CBS_MEMFAIL		dynamic memory allocation failure
	CBS_INVARG		invalid bit mask ID passed

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	set_bit_mask_strings_c, get_enumerated_strings,
	set_enumerated_strings_c, modify_enumerated_strings_c,
	get_enumerated_string_array_c, set_enumerated_string_array_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:

	char	*text;
	char	*text_if_0;
	char	*text_if_1;
	int	status;
	int	num_values;
	int	entry_length;
	int	entry_len_if_0;
	int	entry_len_if_1;
	int	bit_mask_id = 0;
	unsigned int	*bit_numbers;
	HELP_CALLBACK_DATA	*help_info;

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