如何在 Windows NT、Windows 2000 和 Windows XP 中使用VDMDBG函数？

如何在 Windows NT、Windows 2000 和 Windows XP 中使用VDMDBG函数？

编译：

　　即使是在 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 函数仅仅是一个子集。未提及的函数只与调试器有关。



　　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。



　　你可以用 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 

#include 

#include 



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;

}

VDMStartTaskInWOW() 函数在 VDM 中创建一个任务。其声明如下：

BOOL WINAPI VDMStartTaskInWOW( DWORD dwProcessId, LPSTR lpCommandLine,WORD wShow );

　　如果任务成功启动，则该函数返回 TRUE，否则返回 FALSE。dwProcessId VDM 进程ID。lpCommandLine 是一个字符串，表示16-位应用程序的文件名和所带的命令行参数。wShow 表示如何显示窗口。wShow 可以是 16-位 ShowWindow() 函数使用的任何有效值。




　　调用 VDMTerminateTaskWOW() 可以终止 VDM 中的任务。其声明如下：

BOOL WINAPI VDMTerminateTaskWOW( DWORD dwProcessId, WORD htask );

　　如果终止成功该函数返回 TRUE，否则返回 FALSE，dwProcessId 是 VDM 进程ID。hTask 是任务句柄。该任务句柄可以通过调用 VDMEnumTaskWOW() 或者 VDMEnumTaskWOWEx() 获得。
　　这个方法大体上与 Win32 中的 TerminateProcess()相当。如果可能，应尽量避免使用。有时任务无法干净地退出，所以有可能数据丢失。与 Win32 不同，在终止任务后无法保证清除 WowExec。从而造成 VDM 混乱和不可用。为了干净地终止任务，需发送 WM_CLOSE 到其顶层窗口。




　　VDMDBG 的诸函数中没有任何专门处理 16-位 DOS 程序的函数。为了枚举 DOS VDMs，你得用另外一个方法。首先，你得用 VDMEnumProcessWOW() 获得所有 Win16 VDMs 清单，然后想办法（比如用 PSAPI）枚举所有 NTVDM.exe 实例。枚举列表中任何不在 Win16 之列的 NTVDM.exe 就是 DOS VDM。你可以用 CreateProcess() 以及 TerminateProcess() 创建和终止 16-位 DOS 程序。




如何用 Win32 APIs 枚举应用程序窗口和进程？