MSVidWebDVD.RestorePreferredSettings Method
Note This topic applies to Windows XP Service Pack 1 or later.
The RestorePreferredSettings method restores the registry's DVD default language and level settings.
VidWebDVD.RestorePreferredSettings
Parameters
This method takes no parameters.
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. |
| VFW_E_DVD_INVALIDDOMAIN | Must be in Stop domain for this operation. |
| VFW_E_DVD_OPERATION_INHIBITED | UOP control prohibits the operation. |
Valid Domains
The following table shows the domains in which this method is valid.
| Annex J Command Name | Valid Domains |
|---|---|
| None | DVD_DOMAIN_Stop |
Remarks
Properties such as parental level or default audio language that are set using the MSVidWebDVD object are generally applied to the current session only. A user wishing to save these settings as default values in the registry should use the corresponding methods on the MSVidWebDVDAdm object.
Sometimes a user may wish to temporarily change settings, then revert to the saved settings during a viewing session. For example, a parent watching a film may temporarily raise the parental level of the viewer to allow mature content, but wish to restore lower settings after playing a disc. RestorePreferredSettings allows the user to restore the saved DVD language and level settings saved using SaveParentalLevel on the MSVidWebDVDAdm object. The reader must be stopped when executing this method.
Examples
oVidWebDVD.RestorePreferredSettings
Requirements
Type Library |
MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library |
DLL |
Quartz.dll |
See Also
Send comments about this topic to Microsoft
Build date: 7/6/2010