MSVidWebDVD.SelectParentalLevel Method

 
Microsoft DirectShow 9.0

MSVidWebDVD.SelectParentalLevel Method

This topic applies to Windows XP Service Pack 1 or later.

The SelectParentalLevel method sets the parental level for subsequent playback.

Syntax

  VidWebDVD
  .SelectParentalLevel(
  lParentalLevel As Long,
  strUserName As String,
  strPassword As String
)

Parameters

lParentalLevel

Specifies the parental management level as a Long. To enable parental management, lParentalLevel must range from 1 through 8. To disable parental management, set lParentalLevel to -1.

strUserName

Specifies the current user as a String. This method is currently ignored, so use an empty string ("")

strPassword

Specifies the password currently stored in the registry as a String.

Return Values

This method does not return a value.

Error Codes

If the property fails, Err.Number may be set to one of the following values.

Value Description
E_UNEXPECTED Unspecified error.
E_INVALIDARG Country/region value is invalid.
VFW_E_DVD_INVALIDDOMAIN Invalid domain for this method.
E_ACCESSDENIED Incorrect password.

Remarks

This method sets the access level in the MSVidWebDVD object, which determines what content the user can play back. Higher levels can play lower-level content but lower levels can't play higher-level content. The exact meaning of the eight DVD parental management levels varies depending on the country/region. In the United States and Canada, the levels are mapped to the Motion Picture Association of America (MPAA) rating categories. Parental management is disabled by default. 

  • Note   Player parental levels can only be set in the Stop domain.

Example

  oVidWebDVD
  .SelectParentalLevel(
  lParentalLevel
  , "", strPassword)

Valid Domains

The following table shows the Annex J command name to which this method name corresponds, and the domains in which this method is valid.

Annex J Command Name Valid Domains
Parental_Level_Select DVD_DOMAIN_Stop

Requirements

Reference: Add a reference to MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library.

Library: Quartz.dll.

See Also