Function Name: General Class Name To Token

Definition

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

Returns

SE_DRM_SUCCESS - and *drm_class_ptr is set appropriately, if valid parameters were passed in.

SE_DRM_NULL_REQUIRED_PARAMETER - and *drm_class_ptr is left unchanged, if name_ptr or token_ptr is NULL.

SE_DRM_INVALID_VERSION - and *drm_class_ptr is left unaltered, if the specified version of the DRM is not supported.

SE_DRM_CLASS_DOES_NOT_EXIST - and *drm_class_ptr is set to zero (0), if name_ptr does not correspond to a valid DRM class.

Prototype


extern SE_DRM_STATUS_CODE_ENUM
SE_GeneralClassNameToToken
(
SE_PINT16 major_drm_version, (notes)
SE_UINT8 minor_drm_version, (notes)
constchar *name_ptr, (notes)
void *drm_class_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

name_ptr

 candidate name of a token.

drm_class_ptr

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

Prev: General Class Count. Next: General Convert Fields. Up:Index.