如何使用VDMDBG函数

核心提示： INT WINAPI VDMEnumTaskWOW( DWORD dwProcessId, TASKENUMPROC fp,LPARAM lparam );INT WINAPI VDMEnumTaskWOWEx( DWORD dwProcessId, TASKENUMPROCEX fp,L

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 程序。