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

[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 を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
サポートされる最小サーバー	Windows Server 2008
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	wtsapi32.h
ライブラリ	Wtsapi32.lib
DLL	Wtsapi32.dll
API セットの	ext-ms-win-session-wtsapi32-l1-1-0 (Windows 8 で導入)

関連項目

WTS_PROCESS_INFO