VCLinkerTool Interface

  • Article

Exposes the functionality of the linker options.

Namespace:  Microsoft.VisualStudio.VCProjectEngine
Assembly:  Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)

Syntax

'Declaration
<GuidAttribute("A06CDE29-458D-4C82-9B82-163BC2B928F3")> _
Public Interface VCLinkerTool

[GuidAttribute("A06CDE29-458D-4C82-9B82-163BC2B928F3")]
public interface VCLinkerTool

[GuidAttribute(L"A06CDE29-458D-4C82-9B82-163BC2B928F3")]
public interface class VCLinkerTool

[<GuidAttribute("A06CDE29-458D-4C82-9B82-163BC2B928F3")>]
type VCLinkerTool =  interface end

public interface VCLinkerTool

The VCLinkerTool type exposes the following members.

Properties

  Name Description
Public property AdditionalDependencies Gets or sets additional configuration-specific items to add to the link line, such as comdlg32.lib or kernel32.lib.
Public property AdditionalLibraryDirectories Gets or sets one or more additional paths (configuration specific) to search for libraries.
Public property AdditionalManifestDependencies Gets or sets the additional XML manifest fragments that the linker will add to the manifest file.
Public property 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.
Public property AddModuleNamesToAssembly Gets or sets the specified non-assembly file in the final output.
Public property AllowIsolation Gets or sets a value indicating whether to lookup a manifest file without side-by-side assemblies.
Public property AssemblyDebug Gets or sets a value indicating the level of debugging support.
Public property AssemblyLinkResource Gets or sets a value specifying a resource file to link to the output assembly.
Public property 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).
Public property CLRImageType Gets or sets a value indicating the type of a CLR image.
Public property CLRThreadAttribute Gets or sets a value indicating the threading attribute for the entry point of your CLR program.
Public property CLRUnmanagedCodeCheck Determines whether /CLRUNMANAGEDCODECHECK is in effect or not.
Public property DataExecutionPrevention Gets or sets a value that controls the Windows data execution prevention (DEP) feature.
Public property DelayLoadDLLs Gets or sets one or more DLLs for delayed loading.
Public property 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.
Public property driver Gets or sets a value which indicates to the linker which type of driver is being linked.
Public property EmbedManagedResourceFile Gets or sets the specified embedded .NET (or .NET Framework) resource file.
Public property EnableCOMDATFolding Removes redundant COMDAT symbols from the linker output.
Public property EnableUAC Gets or sets a value that controls whether UAC information is embedded in the program manifest.
Public property EntryPointSymbol Gets or sets the starting address (entry point) for an .exe file or DLL.
Public property ErrorReporting Sets or gets the current linker error reporting setting.
Public property ExecutionBucket Infrastructure. Microsoft Internal Use Only.
Public property FixedBaseAddress Gets or sets a value indicating whether an image must be loaded at a fixed address.
Public property ForceSymbolReferences Gets or sets the linker or librarian to include a reference to this symbol.
Public property FunctionOrder Gets or sets COMDATs (functions) in the image in a predetermined order.
Public property GenerateDebugInformation Gets or sets a value enabling generation of debug information.
Public property GenerateManifest Gets or sets a value indicating whether the linker should generate a manifest file.
Public property GenerateMapFile Gets or sets a value indicating whether a map file is generated during linking.
Public property HeapCommitSize Gets or sets a value specifying total heap allocation size in physical memory.
Public property HeapReserveSize Gets or sets a value specifying total heap allocation size in virtual memory.
Public property IgnoreAllDefaultLibraries Gets or sets a value indicating to the linker or librarian to ignore all default libraries.
Public property IgnoreDefaultLibraryNames Gets or sets one or more default libraries to ignore.
Public property IgnoreEmbeddedIDL Gets or sets a value indicating whether to ignore embedded .idlsym sections of object files.
Public property IgnoreImportLibrary Gets or sets a value indicating whether the import library generated by this configuration should not be imported into dependent projects.
Public property ImportLibrary Gets or sets a value specifying which import libraries to generate.
Public property KeyContainer Gets or sets the named container of the key for strongly naming the output assembly.
Public property KeyFile Gets or sets the file that contains the key for strongly naming the output assembly.
Public property LargeAddressAware Gets or sets a value to enable handling addresses larger than 2 GB.
Public property LinkDLL Gets or sets a value specifying whether to build a DLL as the main output.
Public property LinkIncremental Gets or sets a value enabling incremental linking.
Public property LinkLibraryDependencies Sets or gets whether there are link library dependencies.
Public property LinkTimeCodeGeneration Gets or sets a value enabling link time code generation of objects compiled with /GL (Whole Program Optimization).
Public property ManifestFile Gets or sets the name of the manifest file to generate.
Public property MapExports Gets or sets a value indicating whether to include exported functions in map file information.
Public property MapFileName Gets or sets the name for the mapfile.
Public property MergedIDLBaseFileName Specifies the base name of the .idl file that contains the contents of the merged IDLSYM sections.
Public property MergeSections Causes the linker to merge section from into section to; if section to does not exist, section from is renamed to.
Public property MidlCommandFile Specifies a response file for MIDL commands to use.
Public property ModuleDefinitionFile Gets or sets the specified module definition file during executable creation.
Public property OptimizeForWindows98 Gets or sets code on 4-KB boundaries. This improves performance on Windows 98 systems.
Public property OptimizeReferences Enables elimination of functions or data that are never referenced.
Public property OutputFile Overrides the default output file name; the default is based on the first .lib or .obj name on the command line.
Public property PerUserRedirection Gets or sets a value that controls whether COM registration for the current configuration is per-user or per-computer.
Public property Profile Gets or sets a value indicating whether to produce an output file that can be used with the Enterprise Developer performance profiler.
Public property ProfileGuidedDatabase Gets or sets the database file to use when using profile-guided optimizations.
Public property ProgramDatabaseFile Enables generation of a program database .pdb file.
Public property 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.
Public property RegisterOutput Gets or sets a value indicating whether the primary project output should be registered by using Regsvr32 after deployment.
Public property ResourceOnlyDLL Creates a DLL with no entry point. Setting this to true creates a resource-only DLL.
Public property SetChecksum Gets or sets a value enabling the setting of the checksum in the header of an .exe file.
Public property ShowProgress Gets or sets a value that enables a detailed display about linker progress.
Public property StackCommitSize Gets or sets a value indicating the total stack allocation size in physical memory.
Public property StackReserveSize Gets or sets the total stack allocation size in virtual memory.
Public property StripPrivateSymbols Do not put private symbols in the specified, generated .pdb file.
Public property SubSystem Gets or sets a subsystem for the linker.
Public property SupportUnloadOfDelayLoadedDLL Gets or sets a value indicating whether explicit unloading of the delayed load DLLs is allowed.
Public property SuppressStartupBanner Gets or sets a value indicating whether to suppress the display of the startup banner and information messages.
Public property SwapRunFromCD Gets or sets a value indicating whether to run the application from the swap location of the CD.
Public property SwapRunFromNet Gets or sets a value indicating if the application should be run from the swap location of the network.
Public property TargetMachine Gets or sets a value specifying the subsystem for the linker.
Public property TerminalServerAware Enables terminal server awareness.
Public property ToolKind Gets the name of the kind of tool this is.
Public property toolName Gets the name of the specified tool.
Public property ToolPath Gets the path to the specified tool.
Public property 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.
Public property TypeLibraryFile Gets or sets a value that specifies the name of the type library file.
Public property TypeLibraryResourceID Gets or sets a value that specifies the ID number to assign to the .tlb file in the compiled resources.
Public property UACExecutionLevel Gets or sets a value that controls whether User Account Control (UAC) information is embedded in the program manifest.
Public property 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.
Public property UseLibraryDependencyInputs Sets or gets whether independent linking of libraries is enabled.
Public property UseUnicodeResponseFiles Sets or gets whether to use unicode response files.
Public property VCProjectEngine Gets a pointer to the project engine.
Public property Version Gets or sets a value as the version number in the image header.

Top

Methods

  Name Description
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:

The following linker option was removed in Visual Studio 2005:

For more information, see Linker Options.

See Also

Reference

Microsoft.VisualStudio.VCProjectEngine Namespace