/MANIFEST（创建并排程序集清单）

  • 项目

指定链接器是否应创建并排清单文件。

语法

/MANIFEST[:{EMBED[,ID=resource_id]|NO}]

备注

/MANIFEST 链接器选项指示链接器创建并排清单文件。 有关清单文件的更多信息，请参阅清单文件参考。

默认为 /MANIFEST。

/MANIFEST:EMBED 选项指定链接器应该将清单文件作为 RT_MANIFEST 类型的资源嵌入映像。 可选 ID 参数是要用于清单的资源 ID。 对可执行文件使用 resource_id 值 1。 对 DLL 使用值 2 以使其能够指定专用依赖项。 如果未指定 ID 参数，且设置了 /DLL 选项，则默认值为 2；否则，默认值为 1。

从 Visual Studio 2008 开始，可执行文件的清单文件包含一个指定用户帐户控制 (UAC) 信息的部分。 如果指定了 /MANIFEST，但未指定 /MANIFESTUAC 或 /DLL，则会将 UAC 级别设置为 asInvoker 的默认 UAC 片段插入到清单中。 有关 UAC 级别的详细信息，请参阅 /MANIFESTUAC（将 UAC 信息嵌入到清单中）。

若要更改 UAC 的默认行为，请设置以下选项之一：

  • 指定 /MANIFESTUAC 选项并将 UAC 级别设置为所需的值。

  • 或者也可以指定 /MANIFESTUAC:NO 选项（如果不想在清单中生成 UAC 片段）。

如果未指定 /MANIFEST，但指定了 /MANIFESTDEPENDENCY 属性，则会创建清单文件。 如果指定了 /MANIFEST:NO，则不会创建清单文件。

如果指定了 /MANIFEST，则清单文件的名称与输出文件的名称相同，并且会将 .manifest 追加到文件名。 例如，如果输出文件名为 MyFile.exe，则清单文件名为 MyFile.exe.manifest。 如果指定了 /MANIFESTFILE:name，则清单的名称就是在 name 中指定的名称。

在 Visual Studio 开发环境中设置此链接器选项

  1. 打开项目的“属性页” 对话框。 有关详细信息，请参阅设置编译器和生成属性。

  2. 选择“配置属性”>“链接器”>“清单文件”属性页。

  3. 修改“生成清单”属性。 选择“确定”或“应用”以保存更改。

以编程方式设置此链接器选项

  1. 请参阅 GenerateManifest。

另请参阅

清单文件参考
/MANIFESTDEPENDENCY（指定清单依赖项）
/MANIFESTFILE（命名清单文件）
/MANIFESTUAC（将 UAC 信息嵌入到清单中）
MSVC 链接器参考
MSVC 链接器选项