The SEDRIS Data Representation Model
APPENDIX D - Functions
SE GeneralDRMClassStringToDRMClass
extern SE_DRM_Status_Code
SE_GeneralDRMClassStringToDRMClass
(
SE_Short_Integer_Positive major_drm_version, (notes)
SE_Byte_Unsigned minor_drm_version, (notes)
constSE_Character *name_ptr, (notes)
void *result_out_ptr (notes)
);

Definition

Finds the class (if any) whose name exactly matches name_ptr; it is not case-sensitive. The function works for names without underscores, and requires whitespace between the words of the name. Abbreviations of names not allowed.


Returns

SE_DRM_STAT_CODE_SUCCESS and *result_out_ptr is set appropriately, if valid parameters were passed in.
SE_DRM_STAT_CODE_NULL_REQUIRED_PARAMETER and *result_out_ptr is left unchanged, if name_ptr or result_out_ptr is NULL.
SE_DRM_STAT_CODE_INVALID_VERSION and *result_out_ptr is left unchanged, if the specified version of the DRM is not supported.
SE_DRM_STAT_CODE_INVALID_CLASS and *result_out_ptr is set to zero (0), if name_ptr does not correspond to a valid DRM class.


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

name_ptr

 candidate name of a DRM class

result_out_ptr

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


Prev: SE_GeneralClassCount. Next: SE_GeneralEnumerantName. Up:Index.

Last updated: July 16, 2004 Copyright © 2004 SEDRIS