/*
 * TYPEDEF: SE_Object
 *
 *   Pointer to a DRM object.  The definition of a DRM object is
 *   hidden by the implementation of this API.  The user of this API simply
 *   passes in and receives back an SE_Object for functions that deal
 *   with DRM objects.
 *
 *   An SE_Object may be resolved, unresolved or unsaved:
 *
 *     Resolved - the SE_Object points to an object that is available to the
 *                SEDRIS API, i.e. the object is contained within a transmittal
 *                whose content the API can access and the application
 *                programmer has chosen to access that content - i.e., the
 *                transmittal is open.
 *
 *     Unresolved - the SE_Object points to an object that the API cannot
 *                  access or the application programmer has chosen not to
 *                  access it, for example,, the object may reside in a
 *                  transmittal that is not currently open, i.e. the SE_Object
 *                  is an inter-transmittal reference (ITR).
 *
 *     Unsaved - the SE_Object handle is freshly created using SE_CreateObject
 *               but has not yet been added to a transmittal. When it is added
 *               to a transmittal, it will become resolved.
 *
 *   NOTE: To be available for inter-transmittal referencing (ITR), a SEDRIS
 *         object must be published.
 */