Function Name: Generalith Enumerator In Type

Definition

If drm_type represents a valid enumerated type available to the DRM, retrieves structural information on the ith enumerator of that type. Enumerator 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_TYPE_DOES_NOT_EXIST - and *result_out_ptr is set to NULL, if drm_type does not correspond to a valid type available to the DRM.

SE_DRM_INVALID_TYPE_CLASSIFICATION - and *result_out_ptr is set to NULL, if drm_type does not correspond to an enumerated type.

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

Prototype


extern SE_DRM_STATUS_CODE_ENUM
SE_GeneralithEnumeratorInType
(
SE_PINT16 major_drm_version, (notes)
SE_UINT8 minor_drm_version, (notes)
SE_PINT16 drm_type, (notes)
SE_UINT16 i, (notes)
constSE_ENUM_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_type

 represents a SEDRIS type, available for use by the DRM.

i

 index of desired enumerator within type.

result_out_ptr

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

Prev: General Type Name. Next: Generalith Field In Class. Up:Index.