WTSLISTENERCONFIGA 構造体 (wtsapi32.h)
リモート デスクトップ サービス リスナーに関する情報が含まれます。 この構造体は、 WTSCreateListener 関数によって使用されます。
構文
typedef struct _WTSLISTENERCONFIGA {
ULONG version;
ULONG fEnableListener;
ULONG MaxConnectionCount;
ULONG fPromptForPassword;
ULONG fInheritColorDepth;
ULONG ColorDepth;
ULONG fInheritBrokenTimeoutSettings;
ULONG BrokenTimeoutSettings;
ULONG fDisablePrinterRedirection;
ULONG fDisableDriveRedirection;
ULONG fDisableComPortRedirection;
ULONG fDisableLPTPortRedirection;
ULONG fDisableClipboardRedirection;
ULONG fDisableAudioRedirection;
ULONG fDisablePNPRedirection;
ULONG fDisableDefaultMainClientPrinter;
ULONG LanAdapter;
ULONG PortNumber;
ULONG fInheritShadowSettings;
ULONG ShadowSettings;
ULONG TimeoutSettingsConnection;
ULONG TimeoutSettingsDisconnection;
ULONG TimeoutSettingsIdle;
ULONG SecurityLayer;
ULONG MinEncryptionLevel;
ULONG UserAuthentication;
CHAR Comment[WTS_COMMENT_LENGTH + 1];
CHAR LogonUserName[USERNAME_LENGTH + 1];
CHAR LogonDomain[DOMAIN_LENGTH + 1];
CHAR WorkDirectory[MAX_PATH + 1];
CHAR InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGA, *PWTSLISTENERCONFIGA;
メンバー
version
このメンバーは予約されています。
fEnableListener
リスナーを有効にするかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
リスナーが無効になっています。
1
リスナーが有効になっています。
MaxConnectionCount
リスナーが受け入れるアクティブな接続の最大数。
fPromptForPassword
リスナーが常にユーザーにパスワードの入力を求めるかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
サーバーで指定されている場合にのみ、ユーザーにパスワードの入力を求めます。
1
常にユーザーにパスワードの入力を求めます。
fInheritColorDepth
ユーザーが指定した色深度をリスナーで使用するかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
サーバーで指定された色深度を使用します。
1
ユーザーが指定した色深度を使用します。
ColorDepth
リスナーの色深度の設定。 この設定は、 fInheritColorDepth メンバーが 0 の場合にのみ適用されます。 これには、次のいずれかの値を指定できます。
1
8 ビット
2
15 ビット
3
16 ビット
4
24 ビット
5
32 ビット
fInheritBrokenTimeoutSettings
ユーザーが指定した BrokenTimeoutSettings 値をリスナーで使用するかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
サーバーで指定された BrokenTimeoutSettings 値を 使用します。
1
ユーザーが指定した BrokenTimeoutSettings 値を使用します。
BrokenTimeoutSettings
接続またはアイドル タイマーの有効期限が切れた場合、または接続エラーが原因で接続が失われた場合にリスナーが実行するアクション。 この設定は、 fInheritBrokenTimeoutSettings メンバーが 0 の場合にのみ適用されます。 このメンバーには、次のいずれかの値を指定できます。
0
接続またはアイドル タイマーが期限切れになった場合、または接続エラーが原因で接続が失われた場合、ユーザーは切断されますが、セッションはサーバー上に残ります。
1
接続またはアイドル タイマーが期限切れになった場合、または接続エラーが原因で接続が失われた場合、セッションは終了します。
fDisablePrinterRedirection
プリンターのリダイレクトを無効にするかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
ユーザーはプリンターのリダイレクトを有効にすることができます。
1
プリンターのリダイレクトが無効になっています。
fDisableDriveRedirection
ドライブのリダイレクトを無効にするかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
ユーザーはドライブのリダイレクトを有効にすることができます。
1
ドライブのリダイレクトが無効になっています。
fDisableComPortRedirection
COM ポート リダイレクトを無効にするかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
ユーザーは COM ポート リダイレクトを有効にすることができます。
1
COM ポート リダイレクトが無効になっています。
fDisableLPTPortRedirection
LPT ポート リダイレクトを無効にするかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
ユーザーは LPT ポート リダイレクトを有効にすることができます。
1
LPT ポート リダイレクトが無効になっています。
fDisableClipboardRedirection
クリップボードのリダイレクトを無効にするかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
ユーザーはクリップボードのリダイレクトを有効にすることができます。
1
クリップボードのリダイレクトが無効になっています。
fDisableAudioRedirection
オーディオ リダイレクトを無効にするかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
ユーザーはオーディオ リダイレクトを有効にすることができます。
1
オーディオ リダイレクトが無効になっています。
fDisablePNPRedirection
リダイレクトプラグ アンド プレイ無効にするかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
ユーザーは、プラグ アンド プレイリダイレクトを有効にすることができます。
1
プラグ アンド プレイリダイレクトは無効になっています。
fDisableDefaultMainClientPrinter
クライアント プリンターが既定のプリンターかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
クライアント プリンターが既定のプリンターではありません。
1
クライアント プリンターが既定のプリンターです。
LanAdapter
リスナーが使用するネットワーク アダプター。
PortNumber
リスナーのポート番号。
fInheritShadowSettings
ユーザーが指定した ShadowSettings 値をリスナーで使用するかどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
サーバーで指定された設定を使用します。
1
ユーザーが指定した設定を使用します。
ShadowSettings
リスナーのリモート コントロール設定。 リモート コントロールを使用すると、ユーザーは別のユーザーの画面上の操作をリモートで監視できます。 この設定は、 fInheritShadowSettings メンバーが 0 の場合にのみ適用されます。 このメンバーには、次のいずれかの値を指定できます。
0
リモート コントロールが無効になっています。
1
リモート コントロールのユーザーは、ユーザーのアクセス許可を使用して、ユーザーのセッションを完全に制御できます。
2
リモート コントロールのユーザーは、ユーザーのセッションを完全に制御できます。ユーザーのアクセス許可は必要ありません。
3
リモート コントロールのユーザーは、ユーザーのアクセス許可を使用して、セッションをリモートで表示できます。リモート ユーザーはセッションをアクティブに制御できません。
4
リモート コントロールのユーザーはセッションをリモートで表示できますが、セッションをアクティブに制御することはできません。ユーザーのアクセス許可は必要ありません。
TimeoutSettingsConnection
最大接続時間 (ミリ秒単位)。 ユーザーがログオンするたびに、タイマーがリセットされます。 0 の値は、接続タイマーが無効になっていることを示します。
TimeoutSettingsDisconnection
ログオンが終了する前にサーバーが切断されたセッションを保持する最大時間 (ミリ秒単位)。 0 の値は、切断タイマーが無効になっていることを示します。
TimeoutSettingsIdle
最大アイドル時間 (ミリ秒単位)。 0 の値は、アイドル タイマーが無効になっていることを示します。
SecurityLayer
リスナーのセキュリティ層。 このメンバーには、次のいずれかの値を指定できます。
0
リモート デスクトップ プロトコル (RDP) は、接続が確立される前に、認証のためにサーバーとクライアントによって使用されます。
1
サーバーとクライアントは、接続が確立される前に認証方法をネゴシエートします。
2
トランスポート層セキュリティ (TLS) プロトコルは、接続が確立される前に、サーバーとクライアントによって認証に使用されます。
MinEncryptionLevel
リスナーの暗号化レベル。 このメンバーには、次のいずれかの値を指定できます。
1
クライアントからサーバーに送信されるデータは、56 ビット暗号化を使用して暗号化されます。 サーバーからクライアントに送信されるデータは暗号化されません。
2
クライアントからサーバー、およびサーバーからクライアントに送信されるすべてのデータは、クライアントでサポートされている最大キー強度を使用して暗号化されます。
3
クライアントからサーバーに送信され、サーバーからクライアントに送信されるすべてのデータは、128 ビット暗号化を使用して暗号化されます。 このレベルの暗号化をサポートしていないクライアントは接続できません。
4
クライアントからサーバー、およびサーバーからクライアントに送信されるすべてのデータは、Federal Information Processing Standards (FIPS) 暗号化アルゴリズムと Microsoft 暗号化モジュールを使用して暗号化および暗号化解除されます。
UserAuthentication
接続を確立する前に、ネットワーク レベルのユーザー認証が必要かどうかを指定します。 このメンバーには、次のいずれかの値を指定できます。
0
ネットワーク レベルのユーザー認証は必要ありません。
1
ネットワーク レベルのユーザー認証が必要です。
Comment[WTS_COMMENT_LENGTH + 1]
リスナーの説明を含む null で終わる文字列。
LogonUserName[USERNAME_LENGTH + 1]
自動ログオン シナリオで使用されるユーザー名を含む null で終わる文字列。
LogonDomain[DOMAIN_LENGTH + 1]
自動ログオン シナリオで使用されるドメイン名を含む null で終わる文字列。
WorkDirectory[MAX_PATH + 1]
初期プログラムの作業ディレクトリのパスを含む null で終わる文字列。
InitialProgram[MAX_PATH + 1]
ユーザーがサーバーにログオンした直後に開始するプログラムの名前を含む null で終わる文字列。
注釈
注意
wtsapi32.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WTSLISTENERCONFIG を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 |
| サポートされている最小のサーバー | Windows Server 2008 R2 |
| Header | wtsapi32.h |