MT task
Note
This task is only available when using the C++ build system.
Wraps the Microsoft Manifest Tool, mt.exe. For more information, see Mt.exe.
Parameters
The following table describes the parameters of the MT task. Most task parameters, and a few sets of parameters, correspond to a command-line option.
Note
The mt.exe documentation uses a hyphen (-) as the prefix for command-line options, but this topic uses a slash (/). Either prefix is acceptable.
| Parameter | Description |
|---|---|
| AdditionalManifestFiles | Optional String[] parameter. Specifies the name of one or more manifest files. For more information, see the /manifest option in Mt.exe. |
| AdditionalOptions | Optional String parameter. A list of command-line options. For example, /<option1> /<option2> /<option#>. Use this parameter to specify command-line options that are not represented by any other MT task parameter. For more information, see Mt.exe. |
| AssemblyIdentity | Optional String parameter. Specifies the attribute values of the assemblyIdentity element of the manifest. Specify a comma-delimited list, where the first component is the value of the name attribute, followed by one or more name/value pairs that have the form, <attribute name>=<attribute_value>.For more information, see the /identity option in Mt.exe. |
| ComponentFileName | Optional String parameter. Specifies the name of the dynamic-link library you intend to build from the .rgs or .tlb files. This parameter is required if you specify the RegistrarScriptFile or TypeLibraryFile MT task parameters. For more information, see the /dll option in Mt.exe. |
| DependencyInformationFile | Optional String parameter. Specifies the dependency information file used by Visual Studio to track build dependency information for the manifest tool. |
| EmbedManifest | Optional Boolean parameter.If true, embeds the manifest file in the assembly. If false, creates as a stand-alone manifest file. |
| EnableDPIAwareness | Optional enum parameter. Values are false, true, and PerMonitorHighDpiAware. If true, adds information to the manifest that marks the application as DPI-aware. Writing a DPI-aware application makes a user interface look consistently good across a wide variety of high-DPI display settings. If PerMonitorHighDpiAware, adds information to the manifest that marks the application as Per-monitor DPI-aware. The default value is false, unless $(UseOfMFC) is set to static or dynamic, in which case the default is true.For more information, see High DPI. |
| GenerateCatalogFiles | Optional Boolean parameter.If true, generates catalog definition (.cdf) files.For more information, see the /makecdfs option in Mt.exe. |
| GenerateCategoryTags | Optional Boolean parameter.If true, causes category tags to be generated. If this parameter is true, the ManifestFromManagedAssemblyMT task parameter must also be specified.For more information, see the /category option in Mt.exe. |
| InputResourceManifests | Optional String parameter. Input the manifest from a resource of type RT_MANIFEST that has the specified identifier. Specify a resource of the form, <file>[;[#]<resource_id>], where the optional <resource_id> parameter is a non-negative, 16-bit number. If no resource_id is specified, the CREATEPROCESS_MANIFEST_RESOURCE default value (1) is used.For more information, see the /inputresource option in Mt.exe. |
| ManifestFromManagedAssembly | Optional String parameter. Generates a manifest from the specified managed assembly. For more information, see the /managedassemblyname option in Mt.exe. |
| ManifestToIgnore | Optional String parameter. (Not used.) |
| OutputManifestFile | Optional String parameter. Specifies the name of the output manifest. If this parameter is omitted and only one manifest is being operated on, that manifest is modified in place. For more information, see the /out option in Mt.exe. |
| OutputResourceManifests | Optional String parameter. Output the manifest to a resource of type RT_MANIFEST that has the specified identifier. The resource is of the form, <file>[;[#]<resource_id>], where the optional <resource_id> parameter is a non-negative, 16-bit number. If no resource_id is specified, the CREATEPROCESS_MANIFEST_RESOURCE default value (1) is used.For more information, see the /outputresource option in Mt.exe. |
| RegistrarScriptFile | Optional String parameter. Specifies the name of the registrar script (.rgs) file to use for registration-free COM manifest support. For more information, see the /rgs option in Mt.exe. |
| ReplacementsFile | Optional String parameter. Specifies the file that contains values for the replaceable strings in the registrar script (.rgs) file. For more information, see the /replacements option in Mt.exe. |
| ResourceOutputFileName | Optional String parameter. Specifies the output resources file used to embed the manifest into the project output. |
| Sources | Optional ITaskItem[] parameter.Specifies a list of manifest source files separated by spaces. For more information, see the /manifest option in Mt.exe. |
| SuppressDependencyElement | Optional Boolean parameter.If true, generates a manifest without dependency elements. If this parameter is true, also specify the ManifestFromManagedAssemblyMT task parameter.For more information, see the /nodependency option in Mt.exe. |
| SuppressStartupBanner | Optional Boolean parameter.If true, prevents the display of the copyright and version number message when the task starts.For more information, see the /nologo option in Mt.exe. |
| TrackerLogDirectory | Optional String parameter.Specifies the intermediate directory where tracking logs for this task are stored. |
| TypeLibraryFile | Optional String parameter. Specifies the name of the type library (.tlb) file. If you specify this parameter, also specify the ComponentFileNameMT task parameter. For more information, see the /tlb option in Mt.exe. |
| UpdateFileHashes | Optional Boolean parameter.If true, computes the hash value of the files at the path specified by the UpdateFileHashesSearchPathMT task parameter, and then updates the value of the hash attribute of the file element of the manifest by using the computed value.For more information, see the /hashupdate option in Mt.exe. Also see the UpdateFileHashesSearchPath parameter in this table. |
| UpdateFileHashesSearchPath | Optional String parameter.Specifies the search path to use when the file hashes are updated. Use this parameter with the UpdateFileHashesMT task parameter. For more information, see the UpdateFileHashes parameter in this table. |
| VerboseOutput | Optional Boolean parameter.If true, displays verbose debugging information.For more information, see the /verbose option in Mt.exe. |