Share via

Oacruser.ini

  • Article

This topic describes the settings in an Oacruser.ini file.

The Oacruser.ini file is an optional file that you can use to customize your OACR configuration. The Oacruser.ini file can contain the same sections as Oacr.ini; however, not all entries that are supported in Oacr.ini are allowed in Oacruser.ini.

Entries in the Oacruser.ini override the corresponding entries in Oacr.ini, except for those entries that use the addition assignment operator (+=). When the addition assignment operator is used, the values for that entry in the Oacruser.ini file are appended to the value read from the Oacr.ini file.

The location of the Oacruser.ini file is set in the Oacr.ini file.

The default location for the WDK is specified as the following:

UserIniLocation=%BASEDIR%\config\

Where the %BASEDIR% is set to the root directory of the WDK release, for example: C:\WinDDK\7600.

[settings] section in Oacruser.ini

In an Oacruser.ini file, the [settings] section can contain same entries as in Oacr.ini, except for the following:

OACRToolsRoot

OACRBuildRoot

PREsharpFrameworkRoot

OACRFeedbackRoot

PathSubstitutions

UserIniLocation

[defaults] section

In an Oacruser.ini file, the [defaults] section can have the same entries as in Oacr.ini, except for the following:

AutoFlavors

ProjectRoot

Platform

CL

CSC

LIB

LINK

MIDL

FilesToCheck

CheckPCHAtCompileTime

RedirectSourceFiles

The following settings are supported only in Oacruser.ini:

  • CheckAllFiles
    All compiled files are checked. This is equivalent to CheckAlwaysSourceFiles=all. Setting CheckAllFiles= 0 causes no action to be taken. Setting CheckAllFiles=1 overrides the FilesToCheck and CheckEditProjectsOnly settings in the Oacr.ini.

    Note The preferred setting is CheckAlwaysSourceFiles=all.

    Valid values: 0, 1

    Default: 0

    Example: CheckAllFiles=1

  • FullCIT
    Configures the oacr checkintest command to look at all files that have been added to the queue. By default, the oacr checkintest command only looks at source files that have write access when the project is configured to only check writeable files (that is, in Oacr.ini FilesToCheck=edit). This is the default behavior even if there is an override in Oacruser.ini to check all files (CheckAllFiles=1). The default behavior ensures that those who are using more aggressive local settings (CheckAllFiles=1) get the same results with the oacr checkintest command as those who do not have local overrides. The FullCIT=1 setting allows those who want to specify a more aggressive setting to be able to include all files into the oacr checkintest command.

    Valid values: 0, 1

    Default: 0

    Example: FullCIT=1

Build flavor specific defaults sections

You can use the same entries as in the [defaults] section of the Oacruser.ini file, except for DefaultFlavor.

Project and build flavor sections

For the project sections, you can use the same entries as in the [defaults] section of the Oacruser.ini.

For the build flavor sections, you can use the same entries as in the [defaults] section in Oacruser.ini, except for DefaultFlavor.

[WarningNumbers] section

You can use the same entries as in the [WarningNumbers] section of the Oacr.ini file.

[Files] section

You can use the same entries as in the [Files] section of the Oacr.ini file.

[ViewerFilters] section

You can use the same entries as in the [ViewerFilters] section of the Oacr.ini file.

[ViewerFilterPresets] section

You can use the same entries as in the [ViewerFilterPresets] section of the Oacr.ini file.

 

 

Send comments about this topic to Microsoft

Build date: 5/3/2011