VCLinkerTool Interface
Exposes the functionality of the linker options.
Namespace: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)
Syntax
'Declaration
<GuidAttribute("C8E9978A-511E-47B6-AD11-43FEBF772C92")> _
Public Interface VCLinkerTool
[GuidAttribute("C8E9978A-511E-47B6-AD11-43FEBF772C92")]
public interface VCLinkerTool
[GuidAttribute(L"C8E9978A-511E-47B6-AD11-43FEBF772C92")]
public interface class VCLinkerTool
[<GuidAttribute("C8E9978A-511E-47B6-AD11-43FEBF772C92")>]
type VCLinkerTool = interface end
public interface VCLinkerTool
The VCLinkerTool type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
AdditionalDependencies | Gets or sets additional configuration-specific items to add to the link line, such as comdlg32.lib or kernel32.lib. |
|
AdditionalLibraryDirectories | Gets or sets one or more additional paths (configuration specific) to search for libraries. |
|
AdditionalManifestDependencies | Gets or sets the additional XML manifest fragments that the linker will add to the manifest file. |
|
AdditionalOptions | Gets or sets options to add to the end of the command line immediately before the file name(s). An example is if an option is not supported in the object model. |
|
AddModuleNamesToAssembly | Gets or sets the specified non-assembly file in the final output. |
|
AllowIsolation | Gets or sets a value indicating whether to lookup a manifest file without side-by-side assemblies. |
|
AssemblyDebug | Gets or sets a value indicating the level of debugging support. |
|
AssemblyLinkResource | Gets or sets a value specifying a resource file to link to the output assembly. |
|
BaseAddress | Gets or sets a base address for the program, overriding the default location for an .exe file (at 0x400000) or a DLL (at 0x10000000). |
|
CLRImageType | Gets or sets a value indicating the type of a CLR image. |
|
CLRThreadAttribute | Gets or sets a value indicating the threading attribute for the entry point of your CLR program. |
|
CLRUnmanagedCodeCheck | Determines whether /CLRUNMANAGEDCODECHECK is in effect or not. |
|
DataExecutionPrevention | Gets or sets a value that controls the Windows data execution prevention (DEP) feature. |
|
DelayLoadDLLs | Gets or sets one or more DLLs for delayed loading. |
|
DelaySign | Gets or sets a value indicating whether space should be reserved in the assembly file of a COM wrapper for the later addition of the digital signature with a strong name. This property is meaningful only in Visual C# projects. |
|
driver | Gets or sets a value which indicates to the linker which type of driver is being linked. |
|
EmbedManagedResourceFile | Gets or sets the specified embedded .NET (or .NET Framework) resource file. |
|
EnableCOMDATFolding | Removes redundant COMDAT symbols from the linker output. |
|
EnableUAC | Gets or sets a value that controls whether UAC information is embedded in the program manifest. |
|
EntryPointSymbol | Gets or sets the starting address (entry point) for an .exe file or DLL. |
|
ErrorReporting | Sets or gets the current linker error reporting setting. |
|
ExecutionBucket | Infrastructure. Microsoft Internal Use Only. |
|
FixedBaseAddress | Gets or sets a value indicating whether an image must be loaded at a fixed address. |
|
ForceSymbolReferences | Gets or sets the linker or librarian to include a reference to this symbol. |
|
FunctionOrder | Gets or sets COMDATs (functions) in the image in a predetermined order. |
|
GenerateDebugInformation | Gets or sets a value enabling generation of debug information. |
|
GenerateManifest | Gets or sets a value indicating whether the linker should generate a manifest file. |
|
GenerateMapFile | Gets or sets a value indicating whether a map file is generated during linking. |
|
HeapCommitSize | Gets or sets a value specifying total heap allocation size in physical memory. |
|
HeapReserveSize | Gets or sets a value specifying total heap allocation size in virtual memory. |
|
IgnoreAllDefaultLibraries | Gets or sets a value indicating to the linker or librarian to ignore all default libraries. |
|
IgnoreDefaultLibraryNames | Gets or sets one or more default libraries to ignore. |
|
IgnoreEmbeddedIDL | Gets or sets a value indicating whether to ignore embedded .idlsym sections of object files. |
|
IgnoreImportLibrary | Gets or sets a value indicating whether the import library generated by this configuration should not be imported into dependent projects. |
|
ImportLibrary | Gets or sets a value specifying which import libraries to generate. |
|
KeyContainer | Gets or sets the named container of the key for strongly naming the output assembly. |
|
KeyFile | Gets or sets the file that contains the key for strongly naming the output assembly. |
|
LargeAddressAware | Gets or sets a value to enable handling addresses larger than 2 GB. |
|
LinkDLL | Gets or sets a value specifying whether to build a DLL as the main output. |
|
LinkIncremental | Gets or sets a value enabling incremental linking. |
|
LinkLibraryDependencies | Sets or gets whether there are link library dependencies. |
|
LinkTimeCodeGeneration | Gets or sets a value enabling link time code generation of objects compiled with /GL (Whole Program Optimization). |
|
ManifestFile | Gets or sets the name of the manifest file to generate. |
|
MapExports | Gets or sets a value indicating whether to include exported functions in map file information. |
|
MapFileName | Gets or sets the name for the mapfile. |
|
MergedIDLBaseFileName | Specifies the base name of the .idl file that contains the contents of the merged IDLSYM sections. |
|
MergeSections | Causes the linker to merge section from into section to; if section to does not exist, section from is renamed to. |
|
MidlCommandFile | Specifies a response file for MIDL commands to use. |
|
ModuleDefinitionFile | Gets or sets the specified module definition file during executable creation. |
|
OptimizeForWindows98 | Gets or sets code on 4-KB boundaries. This improves performance on Windows 98 systems. |
|
OptimizeReferences | Enables elimination of functions or data that are never referenced. |
|
OutputFile | Overrides the default output file name; the default is based on the first .lib or .obj name on the command line. |
|
PerUserRedirection | Gets or sets a value that controls whether COM registration for the current configuration is per-user or per-computer. |
|
Profile | Gets or sets a value indicating whether to produce an output file that can be used with the Enterprise Developer performance profiler. |
|
ProfileGuidedDatabase | Gets or sets the database file to use when using profile-guided optimizations. |
|
ProgramDatabaseFile | Enables generation of a program database .pdb file. |
|
RandomizedBaseAddress | Gets or sets a value controls whether to generate an executable image that can be randomly rebased at load time by using the address space layout randomization (ASLR) feature of Windows Vista. |
|
RegisterOutput | Gets or sets a value indicating whether the primary project output should be registered by using Regsvr32 after deployment. |
|
ResourceOnlyDLL | Creates a DLL with no entry point. Setting this to true creates a resource-only DLL. |
|
SetChecksum | Gets or sets a value enabling the setting of the checksum in the header of an .exe file. |
|
ShowProgress | Gets or sets a value that enables a detailed display about linker progress. |
|
StackCommitSize | Gets or sets a value indicating the total stack allocation size in physical memory. |
|
StackReserveSize | Gets or sets the total stack allocation size in virtual memory. |
|
StripPrivateSymbols | Do not put private symbols in the specified, generated .pdb file. |
|
SubSystem | Gets or sets a subsystem for the linker. |
|
SupportUnloadOfDelayLoadedDLL | Gets or sets a value indicating whether explicit unloading of the delayed load DLLs is allowed. |
|
SuppressStartupBanner | Gets or sets a value indicating whether to suppress the display of the startup banner and information messages. |
|
SwapRunFromCD | Gets or sets a value indicating whether to run the application from the swap location of the CD. |
|
SwapRunFromNet | Gets or sets a value indicating if the application should be run from the swap location of the network. |
|
TargetMachine | Gets or sets a value specifying the subsystem for the linker. |
|
TerminalServerAware | Enables terminal server awareness. |
|
ToolKind | Gets the name of the kind of tool this is. |
|
toolName | Gets the name of the specified tool. |
|
ToolPath | Gets the path to the specified tool. |
|
TurnOffAssemblyGeneration | Gets or sets a value specifying that no assembly will be generated although the common language runtime information is present in the object files. |
|
TypeLibraryFile | Gets or sets a value that specifies the name of the type library file. |
|
TypeLibraryResourceID | Gets or sets a value that specifies the ID number to assign to the .tlb file in the compiled resources. |
|
UACExecutionLevel | Gets or sets a value that controls whether User Account Control (UAC) information is embedded in the program manifest. |
|
UACUIAccess | Gets or sets a value that controls whether your application bypasses user interface protection levels and drives input to higher-permission windows on the desktop. |
|
UseLibraryDependencyInputs | Sets or gets whether independent linking of libraries is enabled. |
|
UseUnicodeResponseFiles | Sets or gets whether to use unicode response files. |
|
VCProjectEngine | Gets a pointer to the project engine. |
|
Version | Gets or sets a value as the version number in the image header. |
Top
Methods
| Name | Description | |
|---|---|---|
.gif "Public method") |
get_PropertyOption | Infrastructure. Microsoft Internal Use Only. |
Top
Remarks
The VCLinkerTool object is not available for static library projects. Use VCLibrarianTool for static libraries.
The following new linker options are in Visual Studio 2005:
Three new values can be passed to the /LTCG (Link-time Code Generation) linker option: /LTCG:PGI, /LTCG:PGO, and /LTCG:PGU.
The following linker option was removed in Visual Studio 2005:
- /MAPINFO: LINES (see /MAPINFO (Include Information in Mapfile)).
For more information, see Linker Options.