IWMEncProfile2::get_ValidateMode
.gif) |
The get_ValidateMode method retrieves a Boolean value indicating whether profile settings are validated immediately as they are set.
Syntax
HRESULT get_ValidateMode(
VARIANT_BOOL* pfValidate
);
Parameters
pfValidate
[out] Pointer to a VARIANT_BOOL that indicates whether to validate settings immediately.
Return Values
If the method succeeds, it returns S_OK. If it fails, it supports the IErrorInfo interface and returns an HRESULT error code.
| Return code | Number | Description |
| E_POINTER | 0x80004003 | The pointer to the Boolean is NULL. |
Remarks
When the get_ValidateMode method is VARIANT_TRUE, settings are validated immediately. For example, if you set the put_CompatibilityMode to support Windows Media version 8 and earlier, and then set the put_VBRMode method to peak VBR mode, an error is returned at that time.
You can also use the Validate method to verify that your configuration is correct, and to return a more specific error message for compatibility issues, as well as messages informing you when some settings for a profile are missing. Errors are not returned until you call this method, which is useful when your application is UI-based and you do not want errors returned immediately.
Requirements
Header: wmencode.h
Library: wmenc.exe
See Also