ADRMS Bound License Structure

A license is actually an XrML structure, but to make extracting information from a bound license easier, the Active Directory Rights Management Services SDK exposes an object-oriented structure for a bound license. This structure can be navigated using various DRMGetBoundLicense* functions.

A bound license contains a distilled version of an XrML end-user license. In a bound license, all information not pertaining to the bound user or environment is removed. Additionally, duplicated information, such as condition lists or rights, are combined into single entities.

The following diagram illustrates the generic structure of a bound license. Objects, defined as items that can contain other items, are shown in bold type. Attributes, which do not contain other items, are not bold. Items that can have multiple instances are marked "(1...n)". Some repeated structures are shown on a separate page to make the diagram simpler. The object names used are constants listed in the Msdrmgetinfo.h header file.

Some of these elements are optional. For more information about the structures and tags in an XrML license, see the XrML specifications.

g_wszQUERY_CONTENTIDTYPE
g_wszQUERY_CONTENTIDVALUE
g_wszQUERY_CONTENTSKUTYPE
g_wszQUERY_CONTENTSKUVALUE
g_wszQUERY_ENABLINGPRINCIPALIDTYPE
g_wszQUERY_ENABLINGPRINCIPALIDVALUE
g_wszQUERY_RIGHT (1...n)
     g_wszQUERY_INTERVALTIMECONDITION
         g_wszQUERY_INTERVALTIMEINTERVAL
     g_wszQUERY_OSEXCLUSIONCONDITION
         g_wszQUERY_MINVERSION
         g_wszQUERY_MAXVERSION
     g_wszQUERY_NAME
     g_wszQUERYRIGHTSPARAMETERNAME (1...n)
     g_wszQUERYRIGHTSPARAMETERVALUE (1...n)
     g_wszQUERY_ACCESSCONDITION (1...n)
         g_wszQUERY_PRINCIPAL (1...n)
             Sub-Hierarchy A
     g_wszQUERY_REVOCATIONCONDITION (1...n)
         g_wszQUERY_REFRESHPERIOD
         g_wszQUERY_DISTRIBUTIONPOINT (1...n)
             Sub-Hierarchy A

See Also

Querying Licenses
Active Directory Rights Management Services Reference