WTSEnumerateProcessesA 関数 (wtsapi32.h)

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

構文

BOOL WTSEnumerateProcessesA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOA *ppProcessInfo,
  [out] DWORD              *pCount
);

パラメーター

[in] hServer

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

[in] Reserved

予約;は 0 である必要があります。

[in] Version

列挙要求のバージョンを指定します。 1 にする必要があります。

[out] ppProcessInfo

WTS_PROCESS_INFO構造体の配列へのポインターを受け取る変数へのポインター。 配列内の各構造体には、指定された RD セッション ホスト サーバー上のアクティブなプロセスに関する情報が含まれています。 返されたバッファーを解放するには、 WTSFreeMemory 関数を呼び出します。

[out] pCount

ppProcessInfo バッファーで返されるWTS_PROCESS_INFO構造体の数を受け取る変数へのポインター。

戻り値

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

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

解説

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

注意

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

要件

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

こちらもご覧ください

WTS_PROCESS_INFO