Microsoft DirectX 9.0

MSVidWebDVD.SelectParentalLevel Method

This topic applies to Windows XP Service Pack 1 only.

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

See Also