VCLinkerTool Interface

Definition

Exposes the functionality of the linker options.

[System.Runtime.InteropServices.Guid("6590D9E4-516E-447E-A9D9-A32C15BC562B")]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDual | System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable)]
public interface VCLinkerTool
Attributes

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:

Properties

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 or a DLL.

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

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.

Applies to