IEvalRat::put_BlockedRatingAttributes method (tvratings.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 put_BlockedRatingAttributes method specifies whether to block content that has a specified rating.

Syntax

HRESULT put_BlockedRatingAttributes(
  [in] EnTvRat_System       enSystem,
  [in] EnTvRat_GenericLevel enLevel,
  [in] LONG                 lbfAttrs
);

Parameters

[in] enSystem

Specifies the rating system, as an EnTvRat_System enumeration type.

[in] enLevel

Specifies the rating level, as an EnTvRat_GenericLevel enumeration type. The meaning of this value depends on the rating system.

[in] lbfAttrs

Bitwise combination of zero or more flags from the BfEnTvRat_GenericAttributes enumeration. The flags specify whether the overall rating is blocked, or specific attributes within the rating are blocked.

Return value

The method returns an HRESULT. Possible values include those in the following table.

Return code Description
S_OK
The method succeeded.

Remarks

This method should be called once for each level in a rating system, to specify viewing permissions for that level. The lbfAttrs parameter indicates the permissions for the specified rating level:

  • If no flags are set, this rating level is unrestricted. Any program with this rating level can be viewed.
  • If the BflsBlocked flag is set, this rating level is restricted. No program with this rating level can be viewed.
  • Flags in the range BfIsAttr_1 to BfIsAttr_7 specify content attributes, such as violence or adult language. If one of these flags is set, it means that a program with that content attribute and the specified rating level will be blocked.

Requirements

Requirement Value
Minimum supported client Windows�XP with SP1 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header tvratings.h

See also

IEvalRat Interface