WTSEnumerateProcessesExA 関数 (wtsapi32.h)

指定したリモート デスクトップ セッション ホスト (RD セッション ホスト) サーバーまたはリモート デスクトップ仮想化ホスト (RD 仮想化ホスト) サーバー上のアクティブなプロセスに関する情報を取得します。

構文

BOOL WTSEnumerateProcessesExA(
  [in]      HANDLE hServer,
  [in, out] DWORD  *pLevel,
  [in]      DWORD  SessionId,
  [out]     LPSTR  *ppProcessInfo,
  [out]     DWORD  *pCount
);

パラメーター

[in] hServer

RD セッション ホスト サーバーへのハンドル。 WTSOpenServer 関数によって開かれたハンドルを指定するか、WTS_CURRENT_SERVER_HANDLEを指定して、アプリケーションが実行されているサーバーを示します。

[in, out] pLevel

入力時に、返す情報の種類を指定する DWORD 変数へのポインター。 WTS_PROCESS_INFO構造体の配列 を 返すには、0 を指定します。 WTS_PROCESS_INFO_EX構造体の配列 を 返すには、1 つを指定します。

このパラメーターに有効な値を指定しない場合、出力時に WTSEnumerateProcessesEx はこのパラメーターを 1 に設定し、エラーを返します。 それ以外の場合、出力時に WTSEnumerateProcessesEx はこのパラメーターの値を変更しません。

[in] SessionId

プロセスを列挙するセッション。 サーバー上のすべてのセッションのプロセスを列挙するには、 WTS_ANY_SESSIONを指定します。

[out] ppProcessInfo

WTS_PROCESS_INFO 構造体またはWTS_PROCESS_INFO_EX構造体の配列へのポインターを受け取る変数へのポインター。 構造体の型は、 pLevel パラメーターに渡される値によって決まります。 配列内の各構造体には、アクティブなプロセスに関する情報が含まれています。 配列の使用が完了したら、 WTSFreeMemoryEx 関数を呼び出して解放します。 ポインターを NULL に設定する必要もあります。

[out] pCount

の数を受け取る変数へのポインター
ppProcessInfo パラメーターによって参照されるバッファーで返される構造体。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

関数が失敗した場合は、0 を返します。 エラーの詳細情報を得るには、GetLastError 関数を呼び出します。

注釈

別のユーザー セッションで実行されているプロセスを列挙するには、呼び出し元が Administrators グループのメンバーである必要があります。

注意

wtsapi32.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WTSEnumerateProcessesEx を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7
サポートされている最小のサーバー	Windows Server 2008 R2
対象プラットフォーム	Windows
ヘッダー	wtsapi32.h
Library	Wtsapi32.lib
[DLL]	Wtsapi32.dll
API セット	ext-ms-win-session-wtsapi32-l1-1-0 (Windows 8で導入)

こちらもご覧ください

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX