Share via


MSVidWebDVD.SelectParentalLevel Method

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

The SelectParentalLevel method sets the parental level for subsequent playback.

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 Value

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.

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

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.

Examples

oVidWebDVD.SelectParentalLevel(lParentalLevel, "", strPassword)

Requirements

Type Library Use MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library.
DLL Requires Quartz.dll.

See Also

AcceptParentalLevelChange
Enforcing Parental Management Levels
MSVidWebDVD Object
NotifyParentalLevelChange
Parental Management
PlayerParentalCountry
PlayerParentalLevel
SelectParentalCountry
TitleParentalLevels

Send comments about this topic to Microsoft

Build date: 12/4/2008