|
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_object | 3 |
| ); | |||
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.
| SE_RETCOD_SUCCESS | and the object is created. |
| SE_RETCOD_FAILURE | and the status code is set appropriately if the call failed. |
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 |
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.
|