如何在 Windows NT、Windows 2000 和 Windows XP 中使用VDMDBG函数？
编译：Northtibet
摘要
即使是在 32位环境中编写程序，也经常碰到处理 16位应用程序的情况。在 Windows NT 中，16位程序是运行在虚拟 DOS 机（VDM）中的。VDMDBG.dll
包含许多处理16位程序的有用函数，这个库是 Platform SDK 的一部分。
VDMDBG 中的函数提供了很好的方式在 VDM 中枚举、创建和终止 16位进程（任务）。本文将描述如何在Windows
NT、Windows 2000 和 Windows XP 中使用这些函数。
如果需要使用 VDMDBG 函数，你的工程必须链接 VDMDBG.lib。
下面提及的 VDMDBG 函数仅仅是一个子集。未提及的函数只与调试器有关。
枚举 VDMs
VDMEnumProcessWOW() 函数提供了一种简单的方式来枚举所有 运行 Windows 任务的 VDMs。这些 VDMs 包含 WowExec.exe
任务。DOS VDMs 不在枚举之列。 该函数的声明如下：
INT WINAPI VDMEnumProcessWOW( PROCESSENUMPROC fp, LPARAM lparam );
该函数的返回值是当前运行的 VDMs 数，或者终止枚举前的枚举数目。fp 是一个回调函数指针。该函数针对被枚举的 VDM 被调用一次。lParam
是用户定义的值，这个值被传递给回调函数。
PROCESSENUMPROC 的声明如下：
typedef BOOL ( WINAPI *PROCESSENUMPROC )(
DWORD dwProcessId,
DWORD dwAttributes,
LPARAM lpUserDefined
);
这个函数返回 TRUE 停止枚举，返回 FALSE 继续枚举。dwProcessId 是 NTVDM.exe 进程ID。在调用其它VDM函数时（下面会提到这些函数），你会需要此
ID。
枚举 16-位 Windows 任务
你可以用 VDMEnumTaskWOW() 和 VDMEnumTaskWOWEx() 在特定的 VDM 中枚举任务。两者的差别是 VDMEnumTaskWOWEx()
为回调函数提供更多的信息。你只能使用 VDMEnumProcessWOW() 返回的 VDMs 来调用这些任务枚举函数。用 DOS VDMs
是没有意义的，因为 DOS 应用程序运行在自己的 VDM 中。这两个函数的恶声明如下：
INT WINAPI VDMEnumTaskWOW( DWORD dwProcessId, TASKENUMPROC fp,LPARAM lparam );
INT WINAPI VDMEnumTaskWOWEx( DWORD dwProcessId, TASKENUMPROCEX fp,
LPARAM lparam );
这两个函数的返回值是当前运行在指定 VDM 中的任务数，或者每局终止前的枚举数。dwProcessId 是 VDM 的恶进程ID。fp
是指向回调函数的指针。每个被枚举的任务都调用该函数。lparam 是传给回调函数的用户定义的值。
TASKENUMPROC 和 TASKENUMPROCEX 的定义如下：
typedef BOOL ( WINAPI *TASKENUMPROC )(
DWORD dwThreadId,
WORD hMod16,
WORD hTask16,
LPARAM lpUserDefined
);
typedef BOOL ( WINAPI *TASKENUMPROCEX )(
DWORD dwThreadId,
WORD hMod16,
WORD hTask16,
PSZ pszModName,
PSZ pszFileName,
LPARAM lpUserDefined
);
这些函数返回 TRUE 停止枚举，返回 FALSE 继续枚举。你可以在某个调用中用 hTask16 终止任务。
枚举例子
// Enumerate all 16-bit tasks on the system.
#include <windows.h>
#include <stdio.h>
#include <vdmdbg.h>
BOOL WINAPI ProcessEnumProc( DWORD, DWORD, LPARAM );
BOOL WINAPI TaskEnumProcEx( DWORD, WORD, WORD, PSZ, PSZ, LPARAM );
void main()
{
// 枚举 VDMs.
VDMEnumProcessWOW( (PROCESSENUMPROC)ProcessEnumProc,(LPARAM)NULL );
}
BOOL WINAPI ProcessEnumProc( DWORD dwProcessId, DWORD dwAttrib,LPARAM t )
{
printf("\nProcess ID: %d\n", dwProcessId);
// 使用 VDM 进程 ID 枚举其所有任务
VDMEnumTaskWOWEx(
dwProcessId,
(TASKENUMPROCEX)TaskEnumProcEx,(LPARAM)NULL);
// 继续枚举
return FALSE;
}
BOOL WINAPI TaskEnumProcEx( DWORD dwThreadId, WORD hMod16, WORD hTask16,
PSZ pszModName, PSZ pszFileName, LPARAM lParam )
{
// 显示任务信息
printf("Thread ID: %d\n", dwThreadId);
printf("Module handle: %d\n", hMod16);
printf("Task handle: %d\n", hTask16);
printf("Module Name: %s\n", pszModName);
printf("File Name: %s\n", pszFileName);
// 继续枚举
return FALSE;
}
创建 16-位 任务
VDMStartTaskInWOW() 函数在 VDM 中创建一个任务。其声明如下：
BOOL WINAPI VDMStartTaskInWOW( DWORD dwProcessId, LPSTR lpCommandLine,WORD wShow );
如果任务成功启动，则该函数返回 TRUE，否则返回 FALSE。dwProcessId VDM 进程ID。lpCommandLine
是一个字符串，表示16-位应用程序的文件名和所带的命令行参数。wShow 表示如何显示窗口。wShow 可以是 16-位 ShowWindow()
函数使用的任何有效值。
终止 16-位任务
调用 VDMTerminateTaskWOW() 可以终止 VDM 中的任务。其声明如下：
BOOL WINAPI VDMTerminateTaskWOW( DWORD dwProcessId, WORD htask );
如果终止成功该函数返回 TRUE，否则返回 FALSE，dwProcessId 是 VDM 进程ID。hTask
是任务句柄。该任务句柄可以通过调用 VDMEnumTaskWOW() 或者 VDMEnumTaskWOWEx() 获得。
这个方法大体上与 Win32 中的 TerminateProcess()相当。如果可能，应尽量避免使用。有时任务无法干净地退出，所以有可能数据丢失。与
Win32 不同，在终止任务后无法保证清除 WowExec。从而造成 VDM 混乱和不可用。为了干净地终止任务，需发送 WM_CLOSE
到其顶层窗口。
关于 16-位 DOS 程序
VDMDBG 的诸函数中没有任何专门处理 16-位 DOS 程序的函数。为了枚举 DOS VDMs，你得用另外一个方法。首先，你得用 VDMEnumProcessWOW()
获得所有 Win16 VDMs 清单，然后想办法（比如用 PSAPI）枚举所有 NTVDM.exe 实例。枚举列表中任何不在 Win16 之列的
NTVDM.exe 就是 DOS VDM。你可以用 CreateProcess() 以及 TerminateProcess() 创建和终止
16-位 DOS 程序。
参考文章
