[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
	CreateCxObj -- create a new commodity object. (V36)

   SYNOPSIS
	co = CreateCxObj(type,arg1,arg2);
	D0		 D0   A0   A1

	CxObj *CreateCxObj(ULONG,LONG,LONG);

   FUNCTION
	This function creates a commodity object of type 'type'. It is not
	proper to call this function directly. Each object creation routine
	except CxBroker() is defined as a macro in <libraries/commodities.h>
	These are independently documented.

	All functions which operate on a commodity object are made with
	a reference to the thirty-two bit value returned by this function
	(or by CxBroker()).

   INPUTS
	type - the type of object to create as defined in
	       <libraries/commodities.h>
	arg1 - first argument, meaning depends on 'type'
	arg2 - second argument, meaning depends on 'type'

   RESULTS
	co - a pointer to the new object or NULL if it could not be created.
	     A NULL return indicates typically a lack of system memory. Minor
	     problems in creating an object, such as providing a bad filter
	     description to cx_lib/CxFilter(), typically don't cause failure,
	     but are recorded in an internal error field in the new object
	     which can be accessed via CxObjError().

   SEE ALSO
	CxObjError(), cx_lib/CxFilter(), cx_lib/CxSender(),
	cx_lib/CxSignal(), cx_lib/CxTranslate(), cx_lib/CxDebug(),
	cx_lib/CxCustom(), CxBroker()