Share via


IESLicenseRenewalResultEvent interface (tuner.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

Implements methods that get information from a LicenseRenewalResult event. This event contains the results of an attempt to renew a license for protected content. If the attempt succeeds, the results contain the license; if the attempt fails, the results contain error information.

Inheritance

The IESLicenseRenewalResultEvent interface inherits from IESEvent. IESLicenseRenewalResultEvent also has these types of members:

Methods

The IESLicenseRenewalResultEvent interface has these methods.

 
IESLicenseRenewalResultEvent::GetCallersId

Gets a unique identifier from a LicenseRenewalResult event that identifies the caller.
IESLicenseRenewalResultEvent::GetCASFailureCode

Gets a code from a LicenseRenewalResult event that indicates the reason for the failure in the conditional access system (CAS).
IESLicenseRenewalResultEvent::GetDescrambledStatus

Gets a code from a LicenseRenewalResult event that indicates the result of an attempt to descramble protected content.
IESLicenseRenewalResultEvent::GetEntitlementToken

Gets the entitlement token in a protected-content license from a LicenseRenewalResult event. Clients can call the GetEntitlementTokenLength method to get the number of bytes to read from this buffer.
IESLicenseRenewalResultEvent::GetEntitlementTokenLength

Gets the length of the entitlement token in a protected-content license from a LicenseRenewalResult event.
IESLicenseRenewalResultEvent::GetExpiryDate

Gets the expiry date of a renewed protected-content license from a LicenseRenewalResult event.
IESLicenseRenewalResultEvent::GetFileName

Gets the file name for the license to renew from a LicenseRenewalResult event.
IESLicenseRenewalResultEvent::GetRenewalHResult

Gets the final HRESULT value from a LicenseRenewalResult event that is returned by a call to a COM interface method during the renewal process.
IESLicenseRenewalResultEvent::GetRenewalResultCode

Gets a constant from a Protected Broadcast Driver Architecture (PBDA) LicenseRenewalResult event that indicates which step in the renewal process caused the renewal to succeed or fail.
IESLicenseRenewalResultEvent::IsCheckEntitlementCallRequired

Gets a flag from a LicenseRenewalResult event that indicates whether the client should check the entitlement token from the license. The client can call the IBDA_ConditionalAccessEx::CheckEntitlementToken method to validate the entitlement token.
IESLicenseRenewalResultEvent::IsRenewalSuccessful

Gets a flag from a LicenseRenewalResult event that indicates whether the renewal was successful. In the event of failure, a client can call the GetRenewalResultCode or GetRenewalHResult method to get information about the reason for the failure.

Remarks

To declare the interface identifier (IID) for this interface, use the __uuidof operator: __uuidof(IESLicenseRenewalResultEvent).

Requirements

Requirement Value
Minimum supported client Windows�7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header tuner.h