IBDA_ConditionalAccess::get_SmartCardInfo 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.]

The get_SmartCardInfo method retrieves information about the smart card.

Syntax

HRESULT get_SmartCardInfo(
  [out] BSTR               *pbstrCardName,
  [out] BSTR               *pbstrCardManufacturer,
  [out] VARIANT_BOOL       *pfDaylightSavings,
  [out] BYTE               *pbyRatingRegion,
  [out] LONG               *plTimeZoneOffsetMinutes,
  [out] BSTR               *pbstrLanguage,
  [out] EALocationCodeType *pEALocationCode
);

Parameters

[out] pbstrCardName

Receives a string containing the card name. When the string is no longer required, call the SysFreeString function to free it.

[out] pbstrCardManufacturer

Receives a string containing the name of the card manufacturer. When the string is no longer required, call the SysFreeString function to free it.

[out] pfDaylightSavings

Receives a value indicating whether daylight savings is in effect. If the value is VARIANT_TRUE, daylight savings is in effect. If the value is VARIANT_FALSE, daylight savings is not in effect.

[out] pbyRatingRegion

Receives a value indicating the rating region.

[out] plTimeZoneOffsetMinutes

Receives the time zone offset in minutes.

[out] pbstrLanguage

Receives a string indicating the language. When the string is no longer required, call the SysFreeString function to free it.

[out] pEALocationCode

Pointer to a buffer that receives the emergency alert location code information. The buffer size must be at least sizeof(EALocationCodeType). The method writes a structure of type EALocationCodeType to the buffer. The structure specifies the location code scheme (for example, SCTE 18), state, county, and county subdivision for the emergency alert.

Return value

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

Requirements

See also

IBDA_ConditionalAccess Interface