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 |