Function Name: Generalith Field In Class

Definition

Retrieves structural information about the ith field of the given DRM class. Field information is indexed from 0.

Returns

SE_DRM_SUCCESS - if valid parameters were passed in.

SE_DRM_NULL_REQUIRED_PARAMETER - and *result_out_ptr is left unaltered, if result_out_ptr is NULL.

SE_DRM_INVALID_VERSION - and *result_out_ptr is set to NULL, if the specified version of the DRM is not supported.

SE_DRM_CLASS_DOES_NOT_EXIST - and *result_out_ptr is set to NULL, if drm_class does not correspond to a valid DRM class.

SE_DRM_FIELD_DOES_NOT_EXIST_WITHIN_CLASS - and *result_out_ptr is set to NULL, if i is out of range for drm_class.

Prototype


extern SE_DRM_STATUS_CODE_ENUM
SE_GeneralithFieldInClass
(
SE_PINT16 major_drm_version, (notes)
SE_UINT8 minor_drm_version, (notes)
SE_PINT16 drm_class, (notes)
SE_UINT16 i, (notes)
constSE_DRM_FIELD_STRUCTURE **result_out_ptr (notes)
);

Parameters Notes

major_drm_version

 major DRM version number of the DRM version for
 which this function is being called

minor_drm_version

 minor DRM version number of the DRM version for
 which this function is being called

drm_class

 represents a SEDRIS DRM class.

i

 index of desired field within class.

result_out_ptr

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

Prev: Generalith Enumerator In Type. Next: Generalith Field In Type. Up:Index.