WRDS_CONNECTION_SETTINGS_1 結構 (wtsdefs.h)
包含遠端會話的連線設定資訊。
語法
typedef struct _WRDS_CONNECTION_SETTINGS_1 {
BOOLEAN fInheritInitialProgram;
BOOLEAN fInheritColorDepth;
BOOLEAN fHideTitleBar;
BOOLEAN fInheritAutoLogon;
BOOLEAN fMaximizeShell;
BOOLEAN fDisablePNP;
BOOLEAN fPasswordIsScPin;
BOOLEAN fPromptForPassword;
BOOLEAN fDisableCpm;
BOOLEAN fDisableCdm;
BOOLEAN fDisableCcm;
BOOLEAN fDisableLPT;
BOOLEAN fDisableClip;
BOOLEAN fResetBroken;
BOOLEAN fDisableEncryption;
BOOLEAN fDisableAutoReconnect;
BOOLEAN fDisableCtrlAltDel;
BOOLEAN fDoubleClickDetect;
BOOLEAN fEnableWindowsKey;
BOOLEAN fUsingSavedCreds;
BOOLEAN fMouse;
BOOLEAN fNoAudioPlayback;
BOOLEAN fRemoteConsoleAudio;
BYTE EncryptionLevel;
USHORT ColorDepth;
USHORT ProtocolType;
USHORT HRes;
USHORT VRes;
USHORT ClientProductId;
USHORT OutBufCountHost;
USHORT OutBufCountClient;
USHORT OutBufLength;
ULONG KeyboardLayout;
ULONG MaxConnectionTime;
ULONG MaxDisconnectionTime;
ULONG MaxIdleTime;
ULONG PerformanceFlags;
ULONG KeyboardType;
ULONG KeyboardSubType;
ULONG KeyboardFunctionKey;
ULONG ActiveInputLocale;
ULONG SerialNumber;
ULONG ClientAddressFamily;
ULONG ClientBuildNumber;
ULONG ClientSessionId;
WCHAR WorkDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1];
WCHAR UserName[WTS_USERNAME_LENGTH + 1];
WCHAR Domain[WTS_DOMAIN_LENGTH + 1];
WCHAR Password[WTS_PASSWORD_LENGTH + 1];
WCHAR ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1];
WCHAR DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1];
WCHAR imeFileName[WTS_IMEFILENAME_LENGTH + 1];
WCHAR AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR ClientName[WTS_CLIENTNAME_LENGTH + 1];
WCHAR ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1];
WCHAR ClientDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1];
WRDS_SOCKADDR ClientSockAddress;
WRDS_TIME_ZONE_INFORMATION ClientTimeZone;
WRDS_LISTENER_SETTINGS WRdsListenerSettings;
GUID EventLogActivityId;
#if ...
ULONG ContextSize;
#if ...
PBYTE ContextData;
#else
ULONG ContextSize;
#endif
#else
PBYTE ContextData;
#endif
} WRDS_CONNECTION_SETTINGS_1, *PWRDS_CONNECTION_SETTINGS_1;
成員
fInheritInitialProgram
指定是否繼承要在遠端桌面服務殼層中啟動的初始程式。 此值會覆寫 fInheritInitialProgram 接聽程式登錄值。
fInheritColorDepth
指定是否繼承監視器色彩深度。 此值會覆寫 fInheritColorDepth 接聽程式登錄值。
fHideTitleBar
指定標題列是否隱藏。
fInheritAutoLogon
指定登入程式是否為自動。 此值會覆寫 fInheritAutoLogon 接 聽程式登錄值。
fMaximizeShell
指定初始程式是否顯示最大化。 如果 fInheritInitialProgram 設定為 TRUE，則會使用這個值。
fDisablePNP
指定是否啟用 PNP 重新導向。 此值一開始會從原則信息設定。 如果您重設值，則會覆寫原則。
fPasswordIsScPin
指定在登入程式期間使用智慧卡。 智慧卡 PIN 是密碼。 如果 fInheritAutoLogon 設定為 TRUE，則會使用此值。
fPromptForPassword
指定是否要提示使用者輸入密碼。 如果此值為 TRUE，即使 fInheritAutoLogon 登錄值為 TRUE ，也不會設定「永遠要求密碼」原則，也會提示使用者。
fDisableCpm
指定是否啟用印表機對應。 此值一開始會從原則信息設定。 如果您重設值，則會覆寫原則。
fDisableCdm
指定是否啟用磁碟驅動器對應。 此值一開始會從原則信息設定。 如果您重設值，則會覆寫原則。
fDisableCcm
指定是否啟用 COM 埠對應。 此值一開始會從原則信息設定。 如果您重設值，則會覆寫原則。
fDisableLPT
指定是否啟用 LPT 印表機重新導向。 此值一開始會從原則信息設定。 如果您重設值，則會覆寫原則。
fDisableClip
指定是否啟用剪貼簿重新導向。 此值一開始會從原則信息設定。 如果您重設值，則會覆寫原則。
fResetBroken
指定伺服器在連線或閑置定時器到期時，或連線因為連線錯誤而遺失時的動作。
false
會話已中斷連線，但會保留在伺服器上。
TRUE
工作階段已終止。
fDisableEncryption
指定是否要停用客戶端與伺服器之間通訊的加密。
fDisableAutoReconnect
指定是否要停用客戶端的自動重新連線。
fDisableCtrlAltDel
指定是否停用 Ctrl+Alt+Delete 鍵盤快捷方式。
fDoubleClickDetect
指定用戶端是否可以按兩下。
fEnableWindowsKey
指定是否啟用 Windows 金鑰。
fUsingSavedCreds
指定用戶端是否在登入程式期間使用已儲存的認證。
fMouse
指定是否啟用滑鼠輸入。
fNoAudioPlayback
指定是否要開啟音訊播放。 TRUE 的值不會指定任何音訊。
fRemoteConsoleAudio
指定是否要在遠端電腦上保留音訊播放。
EncryptionLevel
指定加密層級。
ColorDepth
指定客戶端監視器色彩深度。 如需可能的值，請參閱 WTS_CLIENT_DISPLAY 結構的 ColorDepth 成員。
ProtocolType
指定通訊協議類型。
HRes
指定客戶端監視器水平解析度。
VRes
指定客戶端監視器垂直解析度。
ClientProductId
用戶端軟體產品識別碼。
OutBufCountHost
主機上的輸出緩衝區數目。
OutBufCountClient
用戶端上的輸出緩衝區數目。
OutBufLength
輸出緩衝區的長度，以位元組為單位。
KeyboardLayout
指定鍵盤配置。
MaxConnectionTime
遠端桌面服務會話的最大持續時間，以分鐘為單位。
MaxDisconnectionTime
中斷連線的遠端桌面服務會話在 RD 工作階段主機伺服器上保持作用中的最長時間量，以分鐘為單位。
MaxIdleTime
遠端桌面服務會話可以維持閑置的最大時間量，以分鐘為單位。
PerformanceFlags
指定可在伺服器上設定的一組功能，以改善效能。 這可以是下列一或多個值的組合。
WRDS_PERF_DISABLE_NOTHING (0x00000000)
未停用任何功能。
WRDS_PERF_DISABLE_WALLPAPER (0x00000001)
桌面上的背景圖案不會顯示。
WRDS_PERF_DISABLE_FULLWINDOWDRAG (0x00000002)
已停用全視窗拖曳;只有在移動視窗時，才會顯示視窗外框。
WRDS_PERF_DISABLE_MENUANIMATIONS (0x00000004)
功能表動畫已停用。
WRDS_PERF_DISABLE_THEMING (0x00000008)
主題已停用。
WRDS_PERF_ENABLE_ENHANCED_GRAPHICS (0x00000010)
啟用增強的圖形。
WRDS_PERF_DISABLE_CURSOR_SHADOW (0x00000020)
游標不會顯示陰影。
WRDS_PERF_DISABLE_CURSORSETTINGS (0x00000040)
數據指標閃爍已停用。
WRDS_PERF_ENABLE_FONT_SMOOTHING (0x00000080)
啟用字型平滑。
WRDS_PERF_ENABLE_DESKTOP_COMPOSITION (0x00000100)
啟用桌面組合。
KeyboardType
指定鍵盤類型。
KeyboardSubType
指定鍵盤子類型。
KeyboardFunctionKey
指定函式索引鍵。
ActiveInputLocale
指定輸入地區設定識別碼。 低字包含語言標識元，高字則包含鍵盤實體配置的裝置句柄。
SerialNumber
用戶端電腦的唯一序號。
ClientAddressFamily
用戶端IP位址系列。
ClientBuildNumber
用戶端組建編號。
ClientSessionId
用戶端會話標識碼。
WorkDirectory[WTS_DIRECTORY_LENGTH + 1]
包含初始程式所在目錄的字串。 如果 fInheritInitialProgram 設定為 TRUE，則會使用這個值。
InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1]
指定初始程式名稱的字串值。 如果 fInheritInitialProgram 設定為 TRUE，則會使用這個值。
UserName[WTS_USERNAME_LENGTH + 1]
指定使用者名稱的字串。 如果 fInheritAutoLogon 設定為 TRUE，則會使用此值。
Domain[WTS_DOMAIN_LENGTH + 1]
指定使用者網域的字串。 如果 fInheritAutoLogon 設定為 TRUE，則會使用此值。
Password[WTS_PASSWORD_LENGTH + 1]
指定用戶密碼的字串。 如果 fInheritAutoLogon 設定為 TRUE，則會使用此值。
ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1]
包含通訊協定名稱的字串。
DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1]
字串，指定要載入之顯示驅動程序的名稱。
DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1]
指定顯示裝置名稱的字串。
imeFileName[WTS_IMEFILENAME_LENGTH + 1]
指定輸入法編輯器名稱。
AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1]
包含要載入之音訊驅動程式名稱的字串。
ClientName[WTS_CLIENTNAME_LENGTH + 1]
字串，包含用戶端計算機的完整名稱。
ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1]
字串，包含以點狀十進位格式表示的用戶端IP位址。
ClientDirectory[WTS_DIRECTORY_LENGTH + 1]
客戶端目錄。
包含客戶端目錄的字串。
ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1]
包含客戶端產品識別碼的字串。
ClientSockAddress
包含套接字地址資訊的 WRDS_SOCKADDR 結構。
ClientTimeZone
包含用戶端時區資訊的 WRDS_TIME_ZONE_INFORMATION 結構。
WRdsListenerSettings
包含接聽程式設定 的WRDS_LISTENER_SETTINGS 結構。
EventLogActivityId
ContextSize
ContextData 陣列的大小，以位元組為單位。
ContextData
位元組陣列，其中包含連接的內容數據。 此陣列的大小是在 ContextSize 成員中指定。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2012 |
| 標頭 | wtsdefs.h (包含 Wtsprotocol.h) |