Bound License Structure

  • Article

[The AD RMS SDK leveraging functionality exposed by the client in Msdrm.dll is available for use in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012, and Windows 8. It may be altered or unavailable in subsequent versions. Instead, use Active Directory Rights Management Services SDK 2.1, which leverages functionality exposed by the client in Msipc.dll.]

Within an Active Directory Rights Management Services (AD RMS) infrastructure, a license is an eXtensible Rights Markup Language (XrML) document. 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, is combined into single entities.

To make it easier to retrieve information from a bound license, you can use the following AD RMS functions:

The following elements, declared in Msdrmgetinfo.h, can be retrieved from a bound license:

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

The following elements make up Sub-Hierarchy A.

g\_wszQUERY\_IDTYPE g\_wszQUERY\_IDVALUE g\_wszQUERY\_NAME g\_wszQUERY\_ADDRESSTYPE (1...n) g\_wszQUERY\_ADDRESSVALUE (1...n)

Querying Licenses

Working with Licenses and Templates