!for_each_module

!for_each_module 扩展为每个加载的模块执行一次调试器命令。

!for_each_module ["CommandString"]
!for_each_module -?

<参数

CommandString
指定要对调试器模块列表中的每个模块执行一次的调试器命令。 如果 CommandString 包含多个命令，则必须用分号 (;) 隔开，并将 CommandString 用引号 (") 括起来。 如果包含多个命令，CommandString 中的单个命令不能包含引号。

可以在 CommandString 或 CommandString 中的命令执行的任何脚本中使用以下别名。

别名	数据类型	值
@#FileVersion	string	模块的文件版本。
@#ProductVersion	string	模块的产品版本。
@#ModuleIndex	ULONG	模块编号。 模块从零开始连续枚举。
@#ModuleName	string	模块名。 此名称通常是不带文件扩展名的文件名。 在一些情况下，模块名称与文件名明显不同。
@#ImageName	string	可执行文件的名称，包括文件扩展名。 通常，完整路径包含在用户模式下，但不包含在内核模式下。
@#LoadedImageName	string	除非存在 Microsoft CodeView 符号，否则此别名与图像名称相同。
@#MappedImageName	string	在大多数情况下，此别名为 NULL。 如果调试器正在映射映像文件（例如，在小型转储调试期间），则此别名是映射映像的名称。
@#SymbolFileName	string	符号文件的路径和名称。 如果尚未加载任何符号，则此别名是可执行文件的名称。
@#ModuleNameSize	ULONG	模块名称字符串的字符串长度加一。
@#ImageNameSize	ULONG	镜像名称字符串的字符串长度加一。
@#LoadedImageNameSize	ULONG	已加载镜像名称字符串的字符串长度加一。
@#MappedImageNameSize	ULONG	映射镜像名称字符串的字符串长度加一。
@#SymbolFileNameSize	ULONG	符号文件名字符串的字符串长度加一。
@#Base	ULONG64	映像的开头地址。
@#Size	ULONG	图像的大小（以字节为单位）。
@#End	ULONG64	图像的末尾地址。
@#TimeDateStamp	ULONG	图像的时间和日期戳。 如果要将此日期和时间戳扩展到可读日期，请使用 .formats（显示数字格式）命令。
@#Checksum	ULONG	模块的校验和。
@#Flags	ULONG	模块标志。 有关 DEBUG_MODULE_Xxx 值的列表，请参阅 Dbgeng.h。
@#SymbolType	USHORT	符号类型。 有关 DEBUG_SYMTYPE_Xxx 值的列表，请参阅 Dbgeng.h。

在为每个模块执行 CommandString之前以及发生任何其他分析之前，将全部替换这些别名。 这些别名区分大小写。 即使别名括在括号中，也必须在别名前后各添加一个空格。 如果使用 C++ 表达式语法，则必须将这些别名引用为 @@( @#alias)。

这些别名仅在调用 !for_each_module 的生存期内可用。 不要将它们与伪寄存器、固定名称别名或用户命名别名混淆。

-?
在“调试器命令”窗口中显示此扩展的一些帮助文本。

DLL

Ext.dll

其他信息

有关如何定义和使用别名作为输入字符串的快捷方式（包括使用 ${ } 令牌）的详细信息，请参阅使用别名。

注解

如果未指定任何参数，!for_each_module 扩展将显示有关已加载模块的常规信息。 此信息类似于以下命令显示的信息。

!for_each_module .echo @#ModuleIndex : @#Base @#End @#ModuleName @#ImageName  @#LoadedImageName

有关已加载和卸载模块的详细信息，请使用 lm（列出加载模块）命令。

如果启用了详细调试器输出，调试器将在调用扩展时显示已加载和卸载模块的总数，调试器会显示有关每个模块（包括每个可用别名的值）的详细信息，然后再为该模块执行 CommandString 。

以下示例演示如何使用 !for_each_module 扩展。 以下命令显示全局调试标志。

!for_each_module x ${@#ModuleName}!*Debug*Flag*
!for_each_module x ${@#ModuleName}!g*Debug*

以下命令使用 !chkimg 扩展检查每个加载模块中的二进制损坏情况：

!for_each_module !chkimg @#ModuleName

以下命令在每个加载的图像中搜索模式“MZ”。

!for_each_module s-a @#Base @#End "MZ"

以下示例演示了对每个模块名称使用 @#FileVersion 和 @#ProductVersion 的情况：

0:000> !for_each_module .echo @#ModuleName fver = @#FileVersion pver = @#ProductVersion 
USER32 fver = 6.0.6000.16438 (vista_gdr.070214-1610) pver = 6.0.6000.16438
kernel32 fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386
ntdll fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386
notepad fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386
WINSPOOL fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386
COMCTL32 fver = 6.10 (vista_rtm.061101-2205) pver = 6.0.6000.16386
SHLWAPI fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386
msvcrt fver = 7.0.6000.16386 (vista_rtm.061101-2205) pver = 7.0.6000.16386
GDI32 fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386
RPCRT4 fver = 6.0.6000.16525 (vista_gdr.070716-1600) pver = 6.0.6000.16525
SHELL32 fver = 6.0.6000.16513 (vista_gdr.070626-1505) pver = 6.0.6000.16513
ole32 fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386
ADVAPI32 fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386
COMDLG32 fver = 6.0.6000.16386 (vista_rtm.061101-2205) pver = 6.0.6000.16386