[SDK32]Win32 でアプリケーションを列挙する方法

• 次の環境で動作する Microsoft(R) Win32(R) Application Programming Interface(API)
  

    - Microsoft(R) Windows NT(R) 4.0
    - Microsoft(R) Windows(R) 95
  
  

概要

Win32 プログラミングで共通する問題の一つに、すべての "アプリケーション" を列挙することがあります。Windows NT 4.0 のタスク マネージャーがそのよい例です。Windows NT 4.0 のタスク マネージャは、2 種類の方法で "アプリケーション" をリストします。タスク マネージャの最初のタブでは、デスクトップ上にあるすべての "アプリケーション ウインドウ" をリストします。タスク マネージャの 2 つ目のタブでは、システム中のすべての "プロセス" をリストします。この資料では、この 2 種類のタスクを Windows 95 と Windows NT の両方で行う方法について詳しく説明します。

詳細

トップレベル ウインドウの列挙

プロセスの列挙と、デスクトップ上のトップレベル ウインドウの列挙を比較した場合、トップレベル ウインドウを列挙する方が比較的簡単です。Windows NT および Windows 95 プラットフォームでトップレベル ウインドウを列挙するには、EnumWindows() 関数を使用します。GetWindow() でウインドウのリストを作成しないようにしてください。Z オーダー変更によって混乱を招き、ウインドウを損失する可能性があるためです。

EnumWindows() は、パラメータとしてユーザー定義の LPARAM 値、さらにコールバック関数を示すポインタを取ります。EnumWindows() は、スクリーン上のウインドウ（またはトップレベル ウインドウ） 1 つに対してコールバック関数を 1 回呼び出します。呼び出されたコールバック関数は、このウインドウ ハンドルに対してリストに追加するなどの何らかの処理を行います。この方法は、Windows の Z オーダーなどによる変更で混乱を招くことのないように保証されています。ウインドウ ハンドルを取得すると、GetWindowText() を呼び出せば、そのタイトルを取得することができます。

プロセスの列挙

システム中のプロセスのリスト作成は、ウインドウの列挙に比べると多少複雑です。これは、システム中のプロセスのリスト作成を行う API 関数が Windows 95 と Windows NT では根本的に異なっているためです。Windows 95 では、ToolHelp32 という API グループの関数を使用しなければいけません。Windows NT では、PSAPI.DLL の関数を使用します。この DLL は Platform SDK で入手することができます。この資料では、Windows 95 および Windows NT の両方の場合について説明します。また、Windows NT と Windows 95 の両方で動作する "EnumProcs()" という ラッパー関数のサンプルも紹介します。

Windows 95 および ToolHelp32:

最初は、Windows 95 で ToolHelp32 を使う方法から見ていきましょう。KERNEL32.DLL に含まれている ToolHelp32 関数は、Windows 95 でのみ使用できる標準 API 関数群です。ToolHelp32 ではシステム中のプロセスやスレッドを列挙するための関数だけでなく、メモリやモジュール情報を取得するための様々な関数を提供していますが、プロセスを列挙するのに必要な関数は、次の 3 つの関数だけです。

   CreateToolhelp32Snapshot(), Process32First(), and Process32Next().

  注意: Process32First() を呼び出す前に、dwSize メンバに sizeof(PROCESSENTRY32)
       をセットするのを忘れないで下さい。

   EnumProcesses(), EnumProcessModules(), GetModuleFileNameEx(),
   GetModuleBaseName().

   BOOL EnumProcesses( DWORD *lpidProcess, DWORD cb, DWORD *cbNeeded );

    nReturned = cbNeeded / sizeof(DWORD)

   EnumProcessModules( hProcess, &hModule, sizeof(hModule), &cbReturned );

   INT WINAPI VDMEnumTaskWOWEx( DWORD dwProcessId, TASKENUMPROCEX fp,
                                LPARAM lparam );

   BOOL WINAPI Enum16( DWORD dwThreadId, WORD hMod16, WORD hTask16, PSZ
                       pszModName, PSZ pszFileName, LPARAM lpUserDefined );

サンプル コード

以下のサンプル コードは PSAPI.DLL と ToolHelp32 を "EnumProcs()" という 1 つの関数にカプセル化したものです。この関数は EnumWindows() と同様の働きをします。つまり関数へのポインタを使い、システム中の各プロセス毎に関数を繰り返し呼び出します。この関数の宣言は次のように行います。

   BOOL WINAPI EnumProcs( PROCENUMPROC lpProc, LPARAM lParam );

   BOOL CALLBACK Proc( DWORD dw, WORD w16, LPCSTR lpstr, LPARAM lParam );

   /*********************
   EnumProc.h
   *********************/
   #include <windows.h>

   typedef BOOL (CALLBACK *PROCENUMPROC)( DWORD, WORD, LPSTR,
      LPARAM ) ;

   BOOL WINAPI EnumProcs( PROCENUMPROC lpProc, LPARAM lParam ) ;

   /*********************
   EnumProc.c (or .cpp)
   *********************/
   #include "EnumProc.h"
   #include <tlhelp32.h>
   #include <vdmdbg.h>

   typedef struct
   {
      DWORD          dwPID ;
      PROCENUMPROC   lpProc ;
      DWORD          lParam ;
      BOOL           bEnd ;
   } EnumInfoStruct ;

   BOOL WINAPI Enum16( DWORD dwThreadId, WORD hMod16, WORD hTask16,
      PSZ pszModName, PSZ pszFileName, LPARAM lpUserDefined ) ;

   // EnumProcs 関数はコールバック関数を示すポインタをとります。
   // このコールバック関数は、プロセス EXE のファイル名とプロセス ID を提供する
   // システム中の、プロセスごとに１回呼ばれます。
   // コールバック関数の定義:
   // BOOL CALLBACK Proc( DWORD dw, LPCSTR lpstr, LPARAM lParam ) ;
   //
   // lpProc - コールバック ルーチンのアドレス。
   //
   // lParam - コールバック ルーチンに渡されるユーザー定義の LPARAM 値。
   //
   BOOL WINAPI EnumProcs( PROCENUMPROC lpProc, LPARAM lParam )
   {
      OSVERSIONINFO  osver ;
      HINSTANCE      hInstLib ;
      HINSTANCE      hInstLib2 ;
      HANDLE         hSnapShot ;
      PROCESSENTRY32 procentry ;
      BOOL           bFlag ;
      LPDWORD        lpdwPIDs ;
      DWORD          dwSize, dwSize2, dwIndex ;
      HMODULE        hMod ;
      HANDLE         hProcess ;
      char           szFileName[ MAX_PATH ] ;
      EnumInfoStruct sInfo ;

      // ToolHelp 関数のポインタ。
      HANDLE (WINAPI *lpfCreateToolhelp32Snapshot)(DWORD,DWORD) ;
      BOOL (WINAPI *lpfProcess32First)(HANDLE,LPPROCESSENTRY32) ;
      BOOL (WINAPI *lpfProcess32Next)(HANDLE,LPPROCESSENTRY32) ;

      // PSAPI 関数のポインタ。
      BOOL (WINAPI *lpfEnumProcesses)( DWORD *, DWORD cb, DWORD * );
      BOOL (WINAPI *lpfEnumProcessModules)( HANDLE, HMODULE *,
         DWORD, LPDWORD );
      DWORD (WINAPI *lpfGetModuleFileNameEx)( HANDLE, HMODULE,
         LPTSTR, DWORD );

      // VDMDBG 関数のポインタ。
      INT (WINAPI *lpfVDMEnumTaskWOWEx)( DWORD,
         TASKENUMPROCEX  fp, LPARAM );

      // 実行されているのが Windows 95 か Windows NT かを確認します。
      osver.dwOSVersionInfoSize = sizeof( osver ) ;
      if( !GetVersionEx( &osver ) )
      {
         return FALSE ;
      }

      // Windows NT の場合:
      if( osver.dwPlatformId == VER_PLATFORM_WIN32_NT )
      {

         // ライブラリをロードし、プロシージャを明示的に取得します。
         // これは、PSAPI.DLL への参照を解決できないという理由で
         // Windows 95 でのロードが失敗しないようにするための配慮です。
         hInstLib = LoadLibraryA( "PSAPI.DLL" ) ;
         if( hInstLib == NULL )
            return FALSE ;

         hInstLib2 = LoadLibraryA( "VDMDBG.DLL" ) ;
         if( hInstLib2 == NULL )
            return FALSE ;

         // プロシージャのアドレスを取得します。
         lpfEnumProcesses = (BOOL(WINAPI *)(DWORD *,DWORD,DWORD*))
            GetProcAddress( hInstLib, "EnumProcesses" ) ;
         lpfEnumProcessModules = (BOOL(WINAPI *)(HANDLE, HMODULE *,
            DWORD, LPDWORD)) GetProcAddress( hInstLib,
            "EnumProcessModules" ) ;
         lpfGetModuleFileNameEx =(DWORD (WINAPI *)(HANDLE, HMODULE,
            LPTSTR, DWORD )) GetProcAddress( hInstLib,
            "GetModuleFileNameExA" ) ;
         lpfVDMEnumTaskWOWEx =(INT(WINAPI *)( DWORD, TASKENUMPROCEX,
            LPARAM))GetProcAddress( hInstLib2, "VDMEnumTaskWOWEx" );
         if( lpfEnumProcesses == NULL ||
            lpfEnumProcessModules == NULL ||
            lpfGetModuleFileNameEx == NULL ||
            lpfVDMEnumTaskWOWEx == NULL)
            {
               FreeLibrary( hInstLib ) ;
               FreeLibrary( hInstLib2 ) ;
               return FALSE ;
            }

         // PSAPI 関数の EnumProcesses を呼び出して、現在システム中にある
         // すべての ProcID を取得します。
         // 注意: ドキュメントには、EnumProcesses の第三パラメータは 
         // cbNeeded であると書かれていますが、これはこの関数を 1度呼び出すと
         // 確保するバッファのサイズを確認することができ、2度目の呼び出しで
         // バッファにデータを格納することができるということを暗に意味してい
         // ます。
         // この説明はこのケースには当てはまりません。CbNeeded パラメータは、
         // 返された PID の数を返します。そのためバッファ サイズがゼロの
         // 場合は、cbNeeded はゼロを返します。
         // 注意: "HeapAlloc" のループは、システム中のすべての PID に対して
         // 適切なサイズのバッファを確実に割り当てるための対策です。
         dwSize2 = 256 * sizeof( DWORD ) ;
         lpdwPIDs = NULL ;
         do
         {
            if( lpdwPIDs )
            {
               HeapFree( GetProcessHeap(), 0, lpdwPIDs ) ;
               dwSize2 *= 2 ;
            }
            lpdwPIDs = HeapAlloc( GetProcessHeap(), 0, dwSize2 );
            if( lpdwPIDs == NULL )
            {
               FreeLibrary( hInstLib ) ;
               FreeLibrary( hInstLib2 ) ;
               return FALSE ;
            }
            if( !lpfEnumProcesses( lpdwPIDs, dwSize2, &dwSize ) )
            {
               HeapFree( GetProcessHeap(), 0, lpdwPIDs ) ;
               FreeLibrary( hInstLib ) ;
               FreeLibrary( hInstLib2 ) ;
               return FALSE ;
            }
         }while( dwSize == dwSize2 ) ;

         // 取得した ProcID の数は？
         dwSize /= sizeof( DWORD ) ;

         // 各 ProcID に対してループ。
         for( dwIndex = 0 ; dwIndex < dwSize ; dwIndex++ )
         {
            szFileName[0] = 0 ;
            // プロセスをオープンします。（セキュリティによってシステム中の
            // 各プロセスにアクセスできない可能性があります。）
            hProcess = OpenProcess(
               PROCESS_QUERY_INFORMATION | PROCESS_VM_READ,
               FALSE, lpdwPIDs[ dwIndex ] ) ;
            if( hProcess != NULL )
            {
               // ここで EnumProcessModules を呼び出して、プロセス中の最初の
               // モジュールのみを取得します。これは、次にフル パス名を取得する
               // ための .EXE モジュールとなるためとても重要な処理です。
               if( lpfEnumProcessModules( hProcess, &hMod,
                  sizeof( hMod ), &dwSize2 ) )
               {
                  // フル パス名を取得します。
                  if( !lpfGetModuleFileNameEx( hProcess, hMod,
                     szFileName, sizeof( szFileName ) ) )
                  {
                     szFileName[0] = 0 ;
                    }
               }
               CloseHandle( hProcess ) ;
            }
            // OpenProcess の成功の有無に関係なく、ProcID を使って enum 関数を
            // 呼ぶことができます。
            if(!lpProc( lpdwPIDs[dwIndex], 0, szFileName, lParam))
               break ;

            // NTVDM はありましたか？
            if( _stricmp( szFileName+(strlen(szFileName)-9),
               "NTVDM.EXE")==0)
            {
               // 16 ビット enum proc の情報を格納します。
               sInfo.dwPID = lpdwPIDs[dwIndex] ;
               sInfo.lpProc = lpProc ;
               sInfo.lParam = lParam ;
               sInfo.bEnd = FALSE ;
               // 16 ビット スタッフを列挙します。
               lpfVDMEnumTaskWOWEx( lpdwPIDs[dwIndex],
                  (TASKENUMPROCEX) Enum16,
                  (LPARAM) &sInfo);

               // メイン enum 関数は終了していますか？
               if(sInfo.bEnd)
                  break ;
            }
         }

         HeapFree( GetProcessHeap(), 0, lpdwPIDs ) ;
         FreeLibrary( hInstLib2 ) ;

      // Windows 95 の場合:
      }else if( osver.dwPlatformId == VER_PLATFORM_WIN32_WINDOWS )
      {

         hInstLib = LoadLibraryA( "Kernel32.DLL" ) ;
         if( hInstLib == NULL )
            return FALSE ;

         // プロシージャのアドレスを取得します。
         // Kernel32 のこれらの関数を明示的にリンクしています。そうしないと
         // このコードを使用するモジュールは、 Kernel32 に Toolhelp32 を
         // 持たない Windows NT 上ではロードに失敗するためです。
         lpfCreateToolhelp32Snapshot=
            (HANDLE(WINAPI *)(DWORD,DWORD))
            GetProcAddress( hInstLib,
            "CreateToolhelp32Snapshot" ) ;
         lpfProcess32First=
            (BOOL(WINAPI *)(HANDLE,LPPROCESSENTRY32))
            GetProcAddress( hInstLib, "Process32First" ) ;
         lpfProcess32Next=
            (BOOL(WINAPI *)(HANDLE,LPPROCESSENTRY32))
            GetProcAddress( hInstLib, "Process32Next" ) ;
         if( lpfProcess32Next == NULL ||
            lpfProcess32First == NULL ||
            lpfCreateToolhelp32Snapshot == NULL )
         {
            FreeLibrary( hInstLib ) ;
            return FALSE ;
         }

         // システム プロセスの Toolhelp スナップショットを示すハンドルを
         // 取得します。
         hSnapShot = lpfCreateToolhelp32Snapshot(
            TH32CS_SNAPPROCESS, 0 ) ;
         if( hSnapShot == INVALID_HANDLE_VALUE )
         {
            FreeLibrary( hInstLib ) ;
            return FALSE ;
         }

         // 最初のプロセスの情報を取得します。
         procentry.dwSize = sizeof(PROCESSENTRY32) ;
         bFlag = lpfProcess32First( hSnapShot, &procentry ) ;

         // プロセスがある間、ループを繰り返します。
         while( bFlag )
         {
            // ファイル名と ProcID を使って enum 関数を呼び出します。
            if(lpProc( procentry.th32ProcessID, 0,
               procentry.szExeFile, lParam ))
            {
               procentry.dwSize = sizeof(PROCESSENTRY32) ;
               bFlag = lpfProcess32Next( hSnapShot, &procentry );
            }else
               bFlag = FALSE ;
         }

      }else
         return FALSE ;

      // ライブラリを開放します。
      FreeLibrary( hInstLib ) ;

      return TRUE ;
   }

   BOOL WINAPI Enum16( DWORD dwThreadId, WORD hMod16, WORD hTask16,
      PSZ pszModName, PSZ pszFileName, LPARAM lpUserDefined )
   {
      BOOL bRet ;

      EnumInfoStruct *psInfo = (EnumInfoStruct *)lpUserDefined ;

      bRet = psInfo->lpProc( psInfo->dwPID, hTask16, pszFileName,
         psInfo->lParam ) ;

      if(!bRet)
      {
         psInfo->bEnd = TRUE ;
      }

      return !bRet;
   }