BFFValidation Element

[This is prerelease documentation and is subject to change in future releases.]

Applies to: Excel | Office 2007 | Office client | PowerPoint | Word

The BFFValidation element is always present in the log file.

Attributes

The BFFValidation element contains the attributes specified in the following table.

Attribute

Description

Details

datetime

The datetime attribute is always present, and contains the date and time that the file was validated.

For example, <BFFValidation path="C:\users\Alice\Sample1_Failing.doc" datetime="01/25/11 09:06:44" result="FAILED">.

result

The result attribute is always present and can be one of several values listed in the Details column.

For example, <BFFValidation path="C:\users\Alice\Sample1_Failing.doc" datetime="01/25/11 09:06:44" result="FAILED">.

  • PASSED

    The file was validated and it contains no file format errors.

  • NOT RECOGNIZED

    The file was not validated because it is not on one of the supported formats.

  • FAILED

    The file was validated and it contains a file format error.

  • ERROR

    BFFValidator encountered an error while validating the file and is unable to complete the validation.

  • ERROR 0xhhhhhhhh Message.

    BFFvalidator encountered an error while validating the file and is unable to complete the validation. However, more information about the error is available and represented by a hexadecimal representation of the error code that is returned by FormatMessage function. For more information, see FormatMessage Function.

path

The path attribute is always present and contains the file path of the file that was validated.

For example, <BFFValidation path="C:\users\Alice\Sample1_Failing.doc" datetime="01/25/11 09:06:44" result="FAILED">

reason

The reason attribute is optional and can provide further details when the result attribute is either NOT RECOGNIZED or ERROR. The reason attribute can be one of the following strings:

  • The Microsoft Office Binary File Format Validator encountered an error reading the file you specified.

  • The Microsoft Office Binary File Format Validator does not support validation of password-protected or encrypted files.

  • The Microsoft Office Binary File Format Validator supports Word, Excel, and PowerPoint binary file formats only. The file you specified is an unsupported file type.

  • The Microsoft Office Binary File Format Validator supports Microsoft Word file versions 97-2003 only. The file you specified is not a supported Microsoft Word file version.

  • The Microsoft Office Binary File Format Validator supports BIFF versions 8 only. The file you specified is not a supported BIFF version.

  • The Microsoft Office Binary File Format Validator supports Microsoft PowerPoint file versions 97-2003 only. The file you specified is not a supported Microsoft PowerPoint file version.

  • The Microsoft Office Binary File Format Validator does not support validation of IRM files.

  • The Microsoft Office Binary File Format Validator encountered a circular reference in the file you specified.

  • No file was specified. Please specify a file and run the command again.

Child Elements

The BFFValidation element contains the following child elements:

See Also

Reference

Microsoft Office Binary File Format Validator Command Line Usage

Other Resources

Introduction to Binary File Format Validator