IBDA_ConditionalAccessEx::CheckEntitlementToken method (bdaiface.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.]
Checks the access availability of content that is identified by an entitlement token.
An entitlement token is a binary blob used to obtain access to a piece of content or to identify an event in a stream.
Syntax
HRESULT CheckEntitlementToken(
[in] ULONG ulDialogRequest,
[in] BSTR bstrLanguage,
[in] BDA_CONDITIONALACCESS_REQUESTTYPE RequestType,
[in] ULONG ulcbEntitlementTokenLen,
[in] BYTE *pbEntitlementToken,
[out] ULONG *pulDescrambleStatus
);
Parameters
[in] ulDialogRequest
A dialog request number that specifies the dialog that might be triggered by setting the value. A dialog is part of the device's user interface (MMI).
[in] bstrLanguage
The language of the dialog. This string contains an ISO 639-2 language code with a dash followed by an ISO 3166 country/region code.
[in] RequestType
The type of access that is being requested, specified as a member of the BDA_CONDITIONALACCESS_REQUESTTYPE enumeration.
[in] ulcbEntitlementTokenLen
The size, in bytes, of the pbEntitlementToken array.
[in] pbEntitlementToken
Pointer to a byte array that contains the entitlement token.
[out] pulDescrambleStatus
Receives a status code indicating the descrambling status. For more information, see Protected Broadcast Driver Architecture, Part 1: Core Services, section 5.5.
Return value
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�7 [desktop apps only] |
| Minimum supported server | Windows Server�2008�R2 [desktop apps only] |
| Target Platform | Windows |
| Header | bdaiface.h |