次の方法で共有

WTS_SESSION_INFO_1W構造体 (wtsapi32.h)

リモート デスクトップ セッション ホスト (RD セッション ホスト) サーバーまたはリモート デスクトップ仮想化ホスト (RD 仮想化ホスト) サーバー上のクライアント セッションに関する拡張情報が含まれています。

構文

typedef struct _WTS_SESSION_INFO_1W {
  DWORD                  ExecEnvId;
  WTS_CONNECTSTATE_CLASS State;
  DWORD                  SessionId;
  LPWSTR                 pSessionName;
  LPWSTR                 pHostName;
  LPWSTR                 pUserName;
  LPWSTR                 pDomainName;
  LPWSTR                 pFarmName;
} WTS_SESSION_INFO_1W, *PWTS_SESSION_INFO_1W;

メンバーズ

ExecEnvId

WTSEnumerateSessionsEx 関数によって返されるセッションのリスト内のセッションを一意に識別する識別子。 詳細については、「解説」を参照してください。

State

リモート デスクトップ サービス セッションの接続状態を指定する WTS_CONNECTSTATE_CLASS 列挙型の値。

SessionId

RD セッション ホスト サーバー、RD 仮想化ホスト サーバー、または仮想マシンによって割り当てられたセッション識別子。

pSessionName

このセッションの名前を含む null で終わる文字列へのポインター。 たとえば、"services"、"console"、"RDP-Tcp#0" などです。

pHostName

セッションが実行されているコンピューターの名前を含む null で終わる文字列へのポインター。 セッションが RD セッション ホスト サーバーまたは RD 仮想化ホスト サーバーで直接実行されている場合、文字列には null含まれます。 セッションが仮想マシンで実行されている場合、文字列には仮想マシンの名前が含まれます。

pUserName

セッションにログオンしているユーザーの名前を含む null で終わる文字列へのポインター。 セッションにログオンしているユーザーがいない場合、文字列には NULLが含まれます。

pDomainName

セッションにログオンしているユーザーのドメイン名を含む null で終わる文字列へのポインター。 セッションにログオンしているユーザーがいない場合、文字列には NULLが含まれます。

pFarmName

仮想マシンが参加しているファームの名前を含む null で終わる文字列へのポインター。 ファームに参加している仮想マシンでセッションが実行されていない場合、文字列には null含まれます。

備考

WTSEnumerateSessionsEx 関数は、関数を呼び出し、WTSOpenServerEx 関数を呼び出して取得した RD 仮想化ホスト サーバーへのハンドルを指定すると、この構造体を返します。 この場合、WTSEnumerateSessionsEx 関数は、ホスト自体で実行されているすべてのセッションと、個々の仮想マシンで実行されているセッションを集計します。 ExecEnvId パラメーターは、集計リスト内の各セッションを一意に識別します。 この識別子は、セッションをホストするサーバーまたは仮想マシンで定義されている実際のセッション識別子とは異なる場合があります。これは、SessionId メンバーによって指定されます。

この構造で表されるセッションは、サーバー上で直接実行されているセッションか、仮想マシン内で実行されているセッションです。 セッションが仮想マシン内で実行されている場合、pHostName メンバーには仮想マシンの名前が含まれます。 pFarmName メンバーは、RD セッション ホスト ファームに参加している仮想マシンでホストされているセッションに適用できます。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 7
サポートされる最小サーバー Windows Server 2008 R2
ヘッダー wtsapi32.h

関連項目

WTSEnumerateSessionsEx の

WTS_SESSION_INFO

  • Last updated on