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

文章翻译 文章翻译
文章编号: 182559 - 查看本文应用于的产品
本文已归档。它按“原样”提供,并且不再更新。
展开全部 | 关闭全部

本文内容

概要

即使在 32 位环境中编程,有与 16 位应用程序的工作所需的时间。在 Windows NT 16-位应用程序运行在一个 DOS 虚拟机 (VDM)。VDMDBG.dll 包含可用于使用 16 位应用程序的许多功能。此库是 Microsoft 平台 SDK 的一部分。

VDMDBG 函数提供枚举、 创建,并终止一个 VDM 中 16 位的进程 (任务) 的好方法。本文介绍如何使用 Microsoft Windows NT、 Windows 2000 和 Windows XP 上的这些函数。

更多信息

当您使用任何 VDMDBG 函数时,您需要与您的项目链接 VDMDBG.lib。

下面提及该 VDMDBG 函数是只有一个可用的函数的子集。但是,该函数没有提到的函数只是与调试器相关的。

枚举的 vdm

VDMEnumProcessWOW() 函数提供了一种简单的方法来枚举所有正在运行的 16 位 Windows 任务的 vdm。这些 vdm 包含 WowExec.exe 任务。 不会枚举 DOS vdm。

此函数的声明如下所示:
   INT WINAPI VDMEnumProcessWOW( PROCESSENUMPROC fp, LPARAM lparam );
				
此函数的返回值是当前正在运行的 vdm 数或数字之前枚举的枚举已终止 fp 是指向回调函数的指针。为每个枚举的 VDM 调用该函数。lParam 是用户定义的值传递给回调函数。

PROCESSENUMPROC 声明,如下所示:
   typedef BOOL ( WINAPI *PROCESSENUMPROC )(
      DWORD dwProcessId,
      DWORD dwAttributes,
      LPARAM lpUserDefined
   );
				
函数应返回 TRUE 停止枚举或继续枚举 dwProcessId 是 NTVDM.exe 进程的进程 ID 为 FALSE。当调用其他下面提及的 VDM 函数时,您将需要此 ID。

枚举 16 位 Windows 任务

您可以使用 VDMEnumTaskWOW() 和 VDMEnumTaskWOWEx() 枚举特定的 VDM 中的任务。两个不同之处是 VDMEnumTaskWOWEx() 提供了指向回调函数的详细信息。您只应使用与这些任务枚举函数返回的 VDMEnumProcessWOW() 的 vdm。使用 DOS vdm 并不进行有意义,因为每个 DOS 应用程序运行在其自己的 VDM 中。

声明:
   INT WINAPI VDMEnumTaskWOW( DWORD dwProcessId, TASKENUMPROC fp,
                              LPARAM lparam );
				
   INT WINAPI VDMEnumTaskWOWEx( DWORD dwProcessId, TASKENUMPROCEX fp,
                                LPARAM lparam );
				
为每个这些函数的返回值是当前运行中指示的 VDM 中,任务数或数字之前枚举的枚举已终止 dwProcessId 是一个指向回调函数的指针的 VDM fp 进程 ID。调用该函数时为每个枚举的任务。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()
   {
      // Enumerate VDMs.
      VDMEnumProcessWOW(
         (PROCESSENUMPROC)ProcessEnumProc,
         (LPARAM)NULL
      );

   }

   BOOL WINAPI ProcessEnumProc( DWORD dwProcessId, DWORD dwAttrib,
      LPARAM t )
   {
      printf("\nProcess ID: %d\n", dwProcessId);

      // Use process ID of VDM to enumerate through its tasks.
      VDMEnumTaskWOWEx(
         dwProcessId,
         (TASKENUMPROCEX)TaskEnumProcEx,
         (LPARAM)NULL
      );

      // Keep enumerating.
      return FALSE;
   }

   BOOL WINAPI TaskEnumProcEx( DWORD dwThreadId, WORD hMod16, WORD hTask16,
      PSZ pszModName, PSZ pszFileName, LPARAM lParam )
   {
      //print task's information
      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);

      // Keep enumerating.
      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 位任务

若要终止 VDM 调用 VDMTerminateTaskWOW() 中的任务。该声明,如下所示是:
   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 vdm,您需要使用另一种方法。第一次,您可以使用 VDMEnumProcessWOW() 使所有的 Win16 vdm 的列表,然后枚举 NTVDM.exe 使用一些其他方案 (如 PSAPI) 的所有实例。从完整枚举不 Win16 列表中的任何 NTVDM.exe 是 DOS VDM。您可以创建和终止 CreateProcess() 和 TerminateProcess() 的 16 位 DOS 应用程序。

属性

文章编号: 182559 - 最后修改: 2014年2月22日 - 修订: 3.4
这篇文章中的信息适用于:
  • Microsoft Win32 Application Programming Interface?当用于
    • Microsoft Windows NT 4.0
    • the operating system: Microsoft Windows 2000
    • the operating system: Microsoft Windows XP
关键字:?
kbnosurvey kbarchive kbmt kbapi kbhowto kbkernbase kbthread KB182559 KbMtzh
机器翻译
注意:这篇文章是由无人工介入的微软自动的机器翻译软件翻译完成。微软很高兴能同时提供给您由人工翻译的和由机器翻译的文章, 以使您能使用您的语言访问所有的知识库文章。然而由机器翻译的文章并不总是完美的。它可能存在词汇,语法或文法的问题,就像是一个外国人在说中文时总是可能犯这样的错误。虽然我们经常升级机器翻译软件以提高翻译质量,但是我们不保证机器翻译的正确度,也不对由于内容的误译或者客户对它的错误使用所引起的任何直接的, 或间接的可能的问题负责。
点击这里察看该文章的英文版: 182559
Microsoft和/或其各供应商对于为任何目的而在本服务器上发布的文件及有关图形所含信息的适用性,不作任何声明。 所有该等文件及有关图形均"依样"提供,而不带任何性质的保证。Microsoft和/或其各供应商特此声明,对所有与该等信息有关的保证和条件不负任何责任,该等保证和条件包括关于适销性、符合特定用途、所有权和非侵权的所有默示保证和条件。在任何情况下,在由于使用或运行本服务器上的信息所引起的或与该等使用或运行有关的诉讼中,Microsoft和/或其各供应商就因丧失使用、数据或利润所导致的任何特别的、间接的、衍生性的损害或任何因使用而丧失所导致的之损害、数据或利润不负任何责任。

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com