VCConfiguration Interface

Definition

The VCConfiguration object programmatically accesses the properties in the General property page of a project's Property Pages dialog box. This object also allows access to the tools used to build this configuration.

[System.Runtime.InteropServices.Guid("921DD76B-A230-4028-8DAE-7FC88A605676")]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDual | System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable)]
public interface VCConfiguration
Attributes

Remarks

For more information, see Working with Project Properties.

Properties

ATLMinimizesCRunTimeLibraryUsage

Causes ATL to link to the C runtime libraries statically to minimize dependencies; requires that useOfATL property is set.

BuildLogFile

Sets or gets the name of the html log file.

CharacterSet

Gets or sets a value that tells the compiler to use the specified character set.

ConfigurationName

Gets or sets the project configuration to be built.

ConfigurationType

Gets or sets the type of output this configuration generates.

DebugSettings

Gets a pointer to the object containing the debug settings information for the selected configuration.

DeleteExtensionsOnClean

Gets or sets which files in the intermediate directory to delete on clean or rebuild.

DeploymentTool

Gets the deployment tool.

DEPRECATED1

Microsoft Internal Use Only.

EnableManagedIncrementalBuild

Deprecated.

ExcludeBuckets

Sets or gets which tool buckets to ignore during a build.

FileTools

Lists the available tools that operate on files.

ImportLibrary

Gets which import library to generate or reports which import library will be generated by the configuration. ImportLibrary exposes the functionality of the /IMPLIB (Name Import Library) linker option.

InheritedPropertySheets

Sets or gets the property sheets for a config.

IntermediateDirectory

Gets or sets a relative path to the intermediate file directory; can include environment variables.

IntrinsicPropertySheets

Microsoft internal use only. Do not use.

ManagedExtensions

Gets or sets a configuration that uses Visual C++. ManagedExtensions exposes the functionality of the C++ compiler's /clr (Common Language Runtime Compilation) option.

Name

Gets or sets the name of the object.

OutputDirectory

Gets or sets the directory in which to place output. The default directory is the project directory.

PerUserRedirection

Gets a value that indicates whether COM registration for the current configuration is per-user or per-computer.

Platform

Gets the platform for which this configuration is being built.

PrimaryOutput

Gets the primary output from building this configuration.

ProgramDatabase

Gets the program database, if any, that the configuration generates.

project

Gets the VCProject associated with the VCConfiguration.

PropertySheets

Gets all property sheets for the project.

RegisterOutput

Gets a value indicating whether the configuration registers the primary output of this build.

Rules

Gets a collection of IVCRulePropertyStorage objects that can modify to project-level properties and default item metadata defined in this property sheet.

SatelliteDLLs

Gets a semicolon-delimited list of all satellite DLLs that this configuration generates.

SqlAssemblyOwner

Sets or gets the SQL assembly owner.

SqlDebugScript

Gets or sets the name of the SQL debug script.

SqlDeploySource

Sets or gets whether to include source files when deploying a SQL assembly.

SqlPermissionLevel

Gets or sets the SQL permission level for the project.

SqlPostDeployScript

Sets or gets the script for post SQL deploy activity.

SqlPreDeployScript

Sets or gets the script for per SQL deploy activity.

Tools

Gets the available tools for the configuration.

UpToDate

Gets a value indicating whether the current configuration's build state is up to date.

useOfATL

Gets or sets a value indicating how ATL is used by the configuration.

useOfMfc

Gets or sets how MFC is used by the configuration.

VCProjectEngine

Gets a pointer to the project engine.

WholeProgramOptimization

Gets or sets cross-module optimizations by delaying code generation to link time. WholeProgramOptimization exposes the functionality of the compiler's /GL (Whole Program Optimization) option.

Methods

AddPropertySheet(String)

Adds a property sheet to the collection of property sheets directly imported by a configuration.

Build()

Builds the current configuration.

BuildAndCallback(bldActionTypes, IVCBuildCompleteCallback)

Begins an asynchronous build of this configuration.

BuildWithProperty(bldActionTypes, String, String, IVCBuildCompleteCallback)

Begins an asynchronous build with a given property set to some value beyond what is defined in the project file.

BuildWithPropertySheet(VCPropertySheet, BuildWithPropertySheetType)

Used to set properties for builds.

BuildWithPropertySheetPath(String, BuildWithPropertySheetType)

Specifies a property sheet search path.

Clean()

Invokes the Clean() command for the current configuration.

ClearToolProperty(Object, String)

Clears the tool property value.

CollectIntelliSenseInfo()
CopyTo(Object)

Copies the current configuration.

Delete()

Microsoft Internal Use Only.

Deploy()

Deploys the project.

Evaluate(String)

Evaluates the value of a project model or environment macro. See Common Macros for Build Commands and Properties for more information about these macros.

GetEvaluatedPropertyValue(String)
GetUnevaluatedPropertyValue(String)
GetVCService(Guid)
IsBuildActionSupported(bldActionTypes)

Indicates whether a specified type of build applies to the currrent project configuration.

IsUpToDate(Object)
MatchName(String, Boolean)

Matches a specified name to the name of a collection item.

MovePropertySheet(VCPropertySheet, Boolean)

Moves a property sheet one position before or after the other property sheets directly imported by this configuration. Position is based on the evaluation order of the property sheets.

Rebuild()

Rebuilds the current configuration.

Relink()

Relink the project.

RemovePropertySheet(VCPropertySheet)

Removes a property sheet from the collection of property sheets directly imported by a configuration.

StopBuild()

Cancels the build currently in progress on the specified configuration.

WaitForBuild()

Suspends processing until build is complete.

Applies to