IBDA_WMDRMSession::RenewLicense Method

[This documentation is preliminary and is subject to change.]
Renews an Extensible Media Rights (XMR) license.


HRESULT RenewLicense(
  [in]       ULONG ulInXmrLicenseLen,
  [in]       BYTE *pbInXmrLicense,
  [in]       ULONG ulEntitlementTokenLen,
  [in]       BYTE *pbEntitlementToken,
  [out]      ULONG *pulDescrambleStatus,
  [in, out]  ULONG *pulOutXmrLicenseLen,
  [in, out]  BYTE *pbOutXmrLicense


  • ulInXmrLicenseLen [in]
    The size of the pbInXmrLicense array, in bytes.

  • pbInXmrLicense [in]
    Pointer to a byte array that contains an XMR license.

  • ulEntitlementTokenLen [in]
    The size of the pbEntitlementToken array, in bytes.

  • pbEntitlementToken [in]
    Pointer to a byte array that contains the original entitlement token for the XML license.

  • pulDescrambleStatus [out]
    Receives the current Conditional Access Service (CAS) descrambling status that is applicable for the entitlement token.

  • pulOutXmrLicenseLen [in, out]
    On input, specifies the number of bytes in the pbOutXmrLicense array. On output, receives the size of the data in the array.

  • pbOutXmrLicense [in, out]
    Pointer to a byte array, allocated by the caller, that receives the renewed XMR license and entitlement token.

Return Value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.


Client Requires Windows 7.
IDL Declared in Bdaiface.idl.

See Also


Send comments about this topic to Microsoft

Build date: 12/4/2008