key_press_init_c

	status.i4.v = key_press_init_c(key.u4.v, modifier.i4.v,
				       callback_func.f.v, callback_data.g.v,
				       key_id.i4.r)

	This routine makes a request to monitor key presses.

	key		key symbol to be monitored  (Use the value
			WMNGR_ALL_KEYS to monitor all key presses.)
			(constants are in X11/keysym)
	modifier	modifier to be monitored
			(WMNGR_NO_MODIFIER_MASK -> no modifier keys pressed,
			 WMNGR_SHIFT_MASK -> shift key pressed,
			 WMNGR_CTRL_MASK -> control key pressed,
			 WMNGR_ALT_MASK -> alt key pressed,
			 WMNGR_LOCK_MASK -> lock key pressed,
			 WMNGR_COMPOSE_MASK -> compose key pressed,
			 WMNGR_ALL_MODIFIER_MASK -> any or no modifier
						    keys pressed)
	callback_func	function to be called when the requested key is pressed
			(called as follows:
			 callback_func(key_data.s.r, callback_data.g.v)
			 ("key_data" is a structure of type
			  KEY_CALLBACK_DATA))
	callback_data	data to be passed to "callback_func"
	key_id		returned key ID (This value can be passed to a
			later call to key_press_cancel_c.)

	This function returns ACNET status values as follows:

	OK			success
	CBS_MEMFAIL		error in allocating dynamic memory

	This function requires the following include files:

	cbslib_h, cns_data_structs_h, acnet_errors_h, X11/keysym.h

	Related functions:

	key_press_cancel_c, key_pressed_c, key_clear_pressed_c

	C/C++ usage:

	int	status;
	int	key_id;
	int	modifier = WMNGR_CTRL_MASK;
	unsigned int	key = 'f';
	void	callback_func(KEY_CALLBACK_DATA *key_data, void *callback_data);
	void	*callback_data = (void *) NULL;

	status = key_press_init_c(key,modifier,callback_func,callback_data,
				  &key_id);