IEvalRat::put_BlockedRatingAttributes Method

This topic applies to Windows XP Service Pack 1 or later.
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

  • enSystem [in]
    Specifies the rating system, as an EnTvRat_System enumeration type.

  • enLevel [in]
    Specifies the rating level, as an EnTvRat_GenericLevel enumeration type. The meaning of this value depends on the rating system.

  • lbfAttrs [in]
    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

Header Declared in Tvratings.h.

See Also

IEvalRat Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008