次の方法で共有

WTS_SESSION_INFO_1A構造体 (wtsapi32.h)

  • [アーティクル]

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

構文

typedef struct _WTS_SESSION_INFO_1A {
  DWORD                  ExecEnvId;
  WTS_CONNECTSTATE_CLASS State;
  DWORD                  SessionId;
  LPSTR                  pSessionName;
  LPSTR                  pHostName;
  LPSTR                  pUserName;
  LPSTR                  pDomainName;
  LPSTR                  pFarmName;
} WTS_SESSION_INFO_1A, *PWTS_SESSION_INFO_1A;

メンバー

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
Header wtsapi32.h

関連項目

WTSEnumerateSessionsEx

WTS_SESSION_INFO