SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API
Functions
SE CreateObject
extern SE_Return_Code
SE_CreateObject
(
SE_Transmittal transmittal,1
SE_DRM_Class new_object_class,2
SE_Object *new_object3
);

Definition

Used to create a new object. The DRM class of the object must be specified. The object's fields are initialized to the default values for that class.

The object is immediately committed to the transmittal upon this call.


Returns

SE_RETCOD_SUCCESS and the object is created.
SE_RETCOD_FAILURE and the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RETCOD_SUCCESS is returned:

SE_STATCODE_SUCCESS and the new object is created, added to the specified transmittal, and a handle to it is placed in *new_object, if valid parameters were passed in and all operations succeeded.

SE_Status_Code(s) when SE_RETCOD_FAILURE is returned:

SE_STATCODE_INVALID_ACCESS_MODE and *new_object is set to NULL, if transmittal was opened in read-only mode.
SE_STATCODE_C_ENUMERATION_VALUE_INVALID and *new_object is set to NULL, if new_object_class does not correspond to a valid, concrete (i.e., not abstract) DRM class.
SE_STATCODE_INACTIONABLE_FAILURE set if the call fails for any other reason

Parameters Notes

1 the transmittal in which the object is being created.

2 the DRM class of the object being created.

3 pointer to a variable, passed in by the user, in which a handle to the object being created will be placed.


Prev: SE_CloseTransmittal. Next: SE_CreateSearchFilter. Up:Index.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS