Autorun.inf 条目 - Win32 apps

2025-09-30 15:41:14

本主题是可用于 Autorun.inf 文件中的条目的参考。 条目由键和值组成。

[AutoRun] 密钥

作

CustomEvent

图标

标签

打开

UseAutoPlay

shellexecute

shell

shell\verb

[内容] 密钥

[ExclusiveContentPaths] 密钥

[IgnoreContentPaths] 密钥

[DeviceInstall] 密钥

DriverPath

[AutoRun]钥匙

作

CustomEvent

图标

标签

打开

UseAutoPlay

shellexecute

shell

shell\verb

操作

作 项指定用于处理程序的“自动播放”对话框中的文本，该处理程序表示在 媒体的 Autorun.inf 文件中打开 或 shellexecute 条目中指定的程序。 该值可以表示为文本或存储在二进制文件中的资源。

action=ActionText

action=@[filepath\]filename,-resourceID

参数

ActionText

在“自动播放”对话框中用于表示 打开 或 shellexecute 媒体 Autorun.inf 文件中指定的程序的处理程序的文本。

filepath

一个字符串，其中包含包含字符串的二进制文件的目录的完全限定路径。 如果未指定路径，则该文件必须位于驱动器的根目录中。

文件名

包含二进制文件名称的字符串。

resourceID

二进制文件中字符串的 ID。

言论

作 密钥仅在 Windows XP Service Pack 2（SP2）或更高版本中使用。 它仅支持DRIVE_REMOVABLE和DRIVE_FIXED类型的驱动器。 对于DRIVE_REMOVABLE，需要 作 密钥。 将忽略音频 CD 或电影 DVD 的 Autorun.inf 文件中的 作 命令，并且这些媒体在 Windows XP Service Pack 1（SP1）及更早版本中继续运行。

“自动播放”对话框中显示的字符串是通过将操作项中指定的文本与Shell提供的、用于命名提供商的固定文本组合在一起来构造的。

图标 旁边显示。 此条目始终显示为“自动播放”对话框中的第一个选项，默认情况下处于选中状态。 如果用户接受该选项，则启动媒体 Autorun.inf 文件中由 打开 或 shellexecute 条目的应用程序。 在这种情况下，始终执行所选作 选项不可用。

作 和 图标 键共同定义最终用户在“自动播放”对话框中看到的应用程序的表示形式。 他们应该以这样一种方式组成，以便用户能够轻松识别它们。 它们应指示要运行的应用程序、创建它的公司以及任何关联的品牌。

为了向后兼容，作 条目对于类型为DRIVE_FIXED的设备是可选的。 对于此类型，如果在 Autorun.inf 文件中不存在任何 作 条目，则会在“自动播放”对话框中使用默认条目。

作 条目对于DRIVE_REMOVABLE类型的设备是必需的，到目前为止，这些设备没有 Autorun.inf 支持。 如果没有 作 条目存在，则会显示“自动播放”对话框，但没有启动其他内容的选项。

自定义事件 (CustomEvent)

customEvent 项 指定自定义自动播放内容事件。

CustomEvent=CustomEventName

参数

CustomEventName

一个包含自动播放内容事件名称的文本字符串。 名称不能超过 100 个字母数字字符。

言论

可以在卷的 Autorun.inf 文件中包括自定义事件名称。 当 AutoPlay 提示用户将应用程序与卷一起使用时，它仅显示已注册指定自定义事件名称的应用程序。 有关如何将应用程序注册为自定义自动播放内容事件的处理程序的信息，请参阅 自动启动自动播放 或 如何注册事件处理程序。

以下示例将值“MyContentOnArrival”指定为新的 AutoPlay 内容事件。

CustomEvent=MyContentOnArrival

图标

图标 项指定一个图标，该图标表示 Windows 用户界面中已启用 AutoRun 的驱动器。

icon=iconfilename[,index]

参数

iconfilename

包含图标信息的.ico、.bmp、.exe或 .dll 文件的名称。 如果文件包含多个图标，则还必须指定图标的从零开始的索引。

言论

该图标与标签一起表示 Windows 用户界面中已启用 AutoRun 的驱动器。 例如，在 Windows 资源管理器中，驱动器由此图标而不是标准驱动器图标表示。 图标的文件必须与 打开 命令指定的文件位于同一目录中。

以下示例指定 MyProg.exe 文件中的第二个图标。

icon=MyProg.exe,1

标签

标签 条目指定一个文本标签，该标签表示 Windows 用户界面中已启用 AutoRun 的驱动器。

label=LabelText

参数

LabelText

包含标签的文本字符串。 它可以包含空格，并且长度不应超过 32 个字符。

注意

可以将值放在 LabelText 参数中，该参数超过 32 个字符，并且不会收到错误消息。 但是，系统仅显示前 32 个字符。 第 32 个之后的任何字符将被截断且不显示。 例如，如果 LabelText 如下所示：label=“此 CD 设计为终极音乐 CD。”将显示以下内容：“此 CD 设计为 ul”。

言论

该标签与图标一起表示 Windows 用户界面中已启用 AutoRun 的驱动器。

以下示例将值“我的驱动器标签”指定为驱动器的标签。

label=My Drive Label

开启

打开 项指定用户在驱动器中插入光盘时自动运行启动的应用程序的路径和文件名。

open=[exepath\]exefile [param1 [param2] ...]

参数

exefile

插入 CD 时运行的可执行文件的完全限定路径。 如果仅指定文件名，则它必须位于驱动器的根目录中。 若要在子目录中找到该文件，必须指定路径。 还可以包含一个或多个要传递给启动应用程序的命令行参数。

使用自动播放

在 Windows XP 上，UseAutoPlay 项指定应使用自动播放，而不是自动运行。

在 Windows Vista 及更高版本上，此项将导致从“自动播放”对话框中取消为自动运行指定的任何作（通过使用 打开 或 shellexecute 条目）。 此条目对早于 Windows XP 的 Windows 版本没有影响。

在 Windows 8 及更高版本上，指定值 0 将禁用此设备的自动播放。

参数

若要使用此选项，请将 UseAutoPlay 条目添加到 Autorun.inf 文件中，并将条目设置为 1。 低于 Windows 8 的 Windows 版本不支持任何其他值。

在 Windows 8 及更高版本上，指定一个值 0 以禁用此设备的自动播放。

UseAutoPlay=1

言论

目前，UseAutoPlay 仅适用于 Windows XP 或更高版本，并且仅适用于 GetDriveType 确定类型为 DRIVE_CDROM的驱动器。

使用 UseAutoPlay 时，打开 或 shellexecute 项中指定的任何作将在 Windows XP 上忽略，并从 Windows Vista 上的“自动播放”对话框中省略。

AutoRun 通常用于自动运行或加载插入媒体中包含的内容，而 AutoPlay 将显示一个对话框，其中包含可能执行的相关作的列表，并允许用户选择要执行的作。 有关 AutoRun 和 AutoPlay 之间的差异的详细信息，请参阅 分别创建启用自动运行 CD-ROM 的应用程序 和 使用和配置自动播放。

用法示例

CD 包含三个文件：Autorun.inf、Readme.txt和 Music.wma。 根据在 Autorun.inf 中指定的 Windows 版本和选项，在插入 CD 时，CD 可由 AutoRun 或 AutoPlay 进行处理（假设为插入 CD 的驱动器启用了 AutoRun/AutoPlay）。

首先，请考虑包含以下内容的 Autorun.inf 文件，指出未指定 UseAutoPlay=1：

[AutoRun]

shellexecute="Readme.txt"

插入此 CD 时，Shell 执行的动作取决于正在使用的 Windows 版本。

在 Windows XP 或更早版本上，此 CD 在插入时由 AutoRun 处理。 在这种情况下， 将读取 shellexecute 条目，并 Shell 调用与 .txt 文件关联的文件处理程序;通常这会在记事本中打开 Readme.txt。

在 Windows Vista 上，存在具有 shellexecute 条目的 Autorun.inf 文件会导致媒体标识为“软件和游戏”自动播放类型。 在这种情况下，用户会显示一个“自动播放”对话框，其中包括由 shellexecute 条目（在对话框中显示为“加载 Readme.txt”）指定的作，以及与类型为“软件和游戏”的媒体关联的默认作。

若要指示应使用 AutoPlay 而不是 Windows XP 上的 AutoRun，并且自动运行 shellexecute 条目指定的作应从 Windows Vista 上的“自动播放”对话框中取消，请将 UseAutoPlay 插入 Autorun.inf 文件中，如下所示：

[AutoRun]

shellexecute="Readme.txt"

UseAutoPlay=1

再次，插入此 CD 时执行的作 Shell 取决于正在使用的 Windows 版本。

在早于 Windows XP 的 Windows 版本中，仍使用 AutoRun，并且执行由 shellexecute 指定的作，如前所述。 （请注意，只有 AutoRun 在早于 Windows XP 的 Windows 版本上可用。

在 Windows XP 上，UseAutoPlay 条目会导致自动播放用于代替 AutoRun。 在这种情况下，AutoPlay 确定媒体包含 Windows 媒体音频（.wma）文件，并将内容分类为“音乐文件”。 用户会显示一个“自动播放”对话框，其中包含“音乐文件”自动播放媒体类型的已注册处理程序;将忽略 AutoRun shellexecute 条目。

shellexecute

版本 5.0。

shellexecute 项指定 AutoRun 将用于调用 ShellExecuteEx的应用程序或数据文件。

shellexecute=[filepath\]filename[param1, [param2]...]

参数

filepath

一个字符串，其中包含包含数据或可执行文件的目录的完全限定路径。 如果未指定路径，则该文件必须位于驱动器的根目录中。

文件名

一个包含文件名的字符串。 如果它是可执行文件，则会启动它。 如果它是数据文件，则它必须是 文件类型的成员。

ShellExecuteEx 启动与文件类型关联的默认命令。

paramx

包含应传递给 ShellExecuteEx的任何其他参数。

言论

此条目类似于 打开，但它允许使用 文件关联 信息来运行应用程序。

shell

该 shell 条目指定驱动器快捷菜单的默认命令。

shell=verb

参数

verb

对应菜单命令的verb。

verb及其关联的菜单命令必须在 Autorun.inf 文件中通过 shell\verb 条目定义。

言论

当用户右键单击驱动器图标时，将显示快捷菜单。 如果存在 Autorun.inf 文件，则会从中获取默认快捷菜单命令。 当用户双击驱动器图标时，此命令也会执行。

若要指定默认快捷菜单命令，请先使用 shell\verb定义其verb、命令字符串和菜单文本。 然后，用于 shell 使其成为默认快捷菜单命令。 否则，默认菜单项文本为“自动播放”，这会启动由打开 项 指定的应用程序。

shell\verb

\shellverb 条目将自定义命令添加到驱动器的快捷菜单。

shell\verb\command=Filename.exe

shell\verb=MenuText

参数

verb

菜单命令中的 verb。

shell\verb\command 条目将verb该文件与可执行文件相关联。 谓词不得包含嵌入空格。 默认情况下， verb 是快捷菜单中显示的文本。

Filename.exe

执行作的应用程序的路径和文件名。

MenuText

此参数指定快捷菜单中显示的文本。 如果省略它， verb 则显示。

MenuText 可以是混合大小写，并且可以包含空格。 可以通过在字母前面放置安和（&）来设置菜单项的快捷键。

言论

当用户右键单击驱动器图标时，将显示快捷菜单。 通过向驱动器的 Autorun.inf 文件添加 shell\verb 条目，可以将命令添加到此快捷菜单。

此条目有两个部分，必须位于单独的行上。 第一部分为 shell\verb\command。 它是必需的。 它将一个名为 a verb的字符串与运行命令时要启动的应用程序相关联。 第二部分是“shell\”verb 条目。 这是可选的。 可以包含它以指定快捷菜单中显示的文本。

为了指定默认快捷菜单命令，请使用 shell\verb 来定义 verb，并通过 shell 条目将其设为默认命令。

以下示例 Autorun.inf 片段将 readitverb 与命令字符串“记事本 abc\readme.txt”相关联。 菜单文本为“Read Me”，“M”定义为项的快捷键。 当用户选择此命令时，驱动器的 abc\readme.txt 文件将打开，其中包含Microsoft记事本。

shell\readit\command=notepad abc\readme.txt

shell\readit=Read &Me

[内容]钥匙

有三个文件类型键：MusicFiles、PictureFiles和 VideoFiles。

如果其中一个内容通过不区分大小写的值 1、y、是、t 或 true 设置为 true，则自动播放 UI 将显示与该内容类型关联的处理程序，而不管该类型的内容是否存在于媒体上。

如果其中一个内容通过不区分大小写的值 0、n、no、f 或 false 设置为 false，则即使媒体上检测到该内容类型的内容，自动播放 UI 也不会显示与该内容类型关联的处理程序。

本部分的用法旨在允许内容作者将内容意图传达给自动播放。 例如，CD 可以分类为仅包含音乐内容，即使它也有图片和视频，否则将被视为具有混合内容。

[内容] 部分仅在 Windows Vista 及更高版本下受支持。

[Content]

MusicFiles=Y

PictureFiles=0

VideoFiles=false

[ExclusiveContentPaths]钥匙

本节中列出的文件夹将“自动播放”限制为仅搜索这些文件夹及其子文件夹以查找内容。 可以带或不带前导反斜杠 （\） 提供它们。 在任一情况下，它们都被视为媒体根目录中的绝对路径。 对于名称中包含空格的文件夹，请勿将它们括在引号中，因为引号作为路径的一部分采用。

本部分的使用旨在允许内容作者将内容意图传达给自动播放，并通过将扫描限制为媒体的某些重要区域来缩短扫描时间。

以下是所有有效路径

[ExclusiveContentPaths]

\music

\music\more music

music2

[ExclusiveContentPaths] 部分仅在 Windows Vista 及更高版本下受支持。

[IgnoreContentPaths]钥匙

在此部分中列出的文件夹及其子文件夹，在搜索媒体查找内容时，自动播放将忽略。 可以带或不带前导反斜杠 （\） 提供它们。 在任一情况下，它们都被视为媒体根目录中的绝对路径。 对于名称中包含空格的文件夹，请勿将它们括在引号中，因为引号作为路径的一部分采用。

本节中的路径优先于 [ExclusiveContentPaths] 节中的路径。 如果 [IgnoreContentPaths] 中给定的路径是 [ExclusiveContentPaths]中给定路径的子文件夹，则仍将被忽略。

本部分的使用旨在允许内容作者将内容意图传达给自动播放，并通过将扫描限制为媒体的某些重要区域来缩短扫描时间。

以下是所有有效路径

[IgnoreContentPaths]

\music

\music\more music

music2

[IgnoreContentPaths] 部分仅在 Windows Vista 及更高版本下受支持。

[DeviceInstall]钥匙

DriverPath

DriverPath 条目指定要以递归方式搜索驱动程序文件的目录。 此命令在驱动程序安装期间使用，不是 AutoRun作的一部分。

[DeviceInstall] 部分仅在 Windows XP 下受支持。

[DeviceInstall]

DriverPath=directorypath

参数

directorypath

Windows 搜索驱动程序文件及其所有子目录的目录的路径。

言论

请勿在 directorypath 中使用驱动器号，因为它们从一台计算机更改为下一台计算机。

若要搜索多个目录，请为每个目录添加 DriverPath 条目，如以下示例所示。

[DeviceInstall]

DriverPath=drivers\video

DriverPath=drivers\audio

如果在 [DeviceInstall] 节中未提供 DriverPath 条目，或者 DriverPath 条目没有值，则在搜索驱动程序文件时会跳过该驱动器。