SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API
Functions
SE GetDRMClass
extern SE_Return_Code
SE_GetDRMClass
(
SE_Object object_in, (notes)
SE_DRM_Class *object_type_out_ptr (notes)
);

Definition

Identifies the DRM class of object passed in as the object_in parameter.

This function is provided as a convenience function, so that a user does not have to call SE_GetFields() in order to find out what DRM class of object was returned in an SE_Object from a call to one of the various functions that return SEDRIS objects. Some of the functions that return SEDRIS objects are: SE_GetNextObject() and and SE_GetNthComponent().


Returns

SE_RET_CODE_SUCCESS and the DRM class is returned.
SE_RET_CODE_FAILUREand the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RET_CODE_SUCCESS is returned:

SE_STAT_CODE_SUCCESS set if valid parameters were passed in and call was successful.

SE_Status_Code(s) when SE_RET_CODE_FAILURE is returned:

SE_STAT_CODE_UNRESOLVED_OUTPUT_OBJECT set if object_in is unresolved.
SE_STAT_CODE_INACTIONABLE_FAILURE set if the call fails for any other reason.


Parameters Notes


object_in

 the object whose DRM class will be returned.

object_type_out_ptr

 a pointer to the variable in the user's memory
    space where the answer will be stored.


Prev: SE_GetContextTransformation. Next: SE_GetDataTableData. Up:Index.

Last updated: July 16, 2004 Copyright © 2004 SEDRIS