VCConfiguration Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.
public interface class VCConfigurationpublic interface class VCConfiguration__interface VCConfiguration[System.Runtime.InteropServices.Guid("921DD76B-A230-4028-8DAE-7FC88A605676")]
[System.Runtime.InteropServices.TypeLibType]
public interface VCConfiguration[<System.Runtime.InteropServices.Guid("921DD76B-A230-4028-8DAE-7FC88A605676")>]
[<System.Runtime.InteropServices.TypeLibType>]
type VCConfiguration = interfacePublic Interface VCConfiguration- Derived
- 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. |