struktur WRDS_CONNECTION_SETTINGS_1 (wtsdefs.h)
Berisi informasi pengaturan koneksi untuk sesi jarak jauh.
Sintaks
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;
Anggota
fInheritInitialProgram
Menentukan apakah program awal yang akan dimulai di shell Layanan Desktop Jauh diwariskan. Nilai ini menimpa nilai registri pendengar fInheritInitialProgram .
fInheritColorDepth
Menentukan apakah akan mewarisi kedalaman warna monitor. Nilai ini menimpa nilai registri pendengar fInheritColorDepth .
fHideTitleBar
Menentukan apakah bilah judul disembunyikan.
fInheritAutoLogon
Menentukan apakah proses masuk otomatis. Nilai ini menimpa nilai registri pendengar fInheritAutoLogon .
fMaximizeShell
Menentukan apakah program awal ditampilkan dimaksimalkan. Nilai ini digunakan jika fInheritInitialProgram diatur ke TRUE.
fDisablePNP
Menentukan apakah pengalihan PNP diaktifkan. Nilai ini awalnya ditetapkan dari informasi kebijakan. Jika Anda mengatur ulang nilai, kebijakan akan ditimpa.
fPasswordIsScPin
Menentukan bahwa kartu pintar digunakan selama proses masuk. PIN kartu pintar adalah kata sandi. Nilai ini digunakan jika fInheritAutoLogon diatur ke TRUE.
fPromptForPassword
Menentukan apakah akan meminta kata sandi kepada pengguna. Jika nilai ini TRUE, pengguna akan diminta bahkan jika nilai registri fInheritAutoLogonadalah TRUE dan kebijakan "Selalu minta kata sandi" tidak ditetapkan.
fDisableCpm
Menentukan apakah pemetaan printer diaktifkan. Nilai ini awalnya ditetapkan dari informasi kebijakan. Jika Anda mengatur ulang nilai, kebijakan akan ditimpa.
fDisableCdm
Menentukan apakah pemetaan drive diaktifkan. Nilai ini awalnya ditetapkan dari informasi kebijakan. Jika Anda mengatur ulang nilai, kebijakan akan ditimpa.
fDisableCcm
Menentukan apakah pemetaan port COM diaktifkan. Nilai ini awalnya ditetapkan dari informasi kebijakan. Jika Anda mengatur ulang nilai, kebijakan akan ditimpa.
fDisableLPT
Menentukan apakah pengalihan printer LPT diaktifkan. Nilai ini awalnya ditetapkan dari informasi kebijakan. Jika Anda mengatur ulang nilai, kebijakan akan ditimpa.
fDisableClip
Menentukan apakah pengalihan papan klip diaktifkan. Nilai ini awalnya ditetapkan dari informasi kebijakan. Jika Anda mengatur ulang nilai, kebijakan akan ditimpa.
fResetBroken
Menentukan tindakan yang diambil server ketika timer koneksi atau diam kedaluwarsa, atau ketika koneksi hilang karena kesalahan koneksi.
FALSE
Sesi terputus, tetapi tetap berada di server.
TRUE
Sesi dihentikan.
fDisableEncryption
Menentukan apakah akan menonaktifkan enkripsi untuk komunikasi antara klien dan server.
fDisableAutoReconnect
Menentukan apakah akan menonaktifkan koneksi ulang otomatis klien.
fDisableCtrlAltDel
Menentukan apakah pintasan keyboard Ctrl+Alt+Delete dinonaktifkan.
fDoubleClickDetect
Menentukan apakah klien dapat mengklik dua kali.
fEnableWindowsKey
Menentukan apakah kunci Windows diaktifkan.
fUsingSavedCreds
Menentukan apakah klien menggunakan kredensial tersimpan selama proses masuk.
fMouse
Menentukan apakah input mouse diaktifkan.
fNoAudioPlayback
Menentukan apakah akan mengaktifkan pemutaran audio. Nilai TRUE tidak menentukan audio.
fRemoteConsoleAudio
Menentukan apakah akan meninggalkan pemutaran audio pada komputer jarak jauh.
EncryptionLevel
Menentukan tingkat enkripsi.
ColorDepth
Menentukan kedalaman warna monitor klien. Untuk nilai yang mungkin, lihat anggota ColorDepth dari struktur WTS_CLIENT_DISPLAY .
ProtocolType
Menentukan jenis protokol.
HRes
Menentukan resolusi horizontal monitor klien.
VRes
Menentukan resolusi vertikal monitor klien.
ClientProductId
ID produk perangkat lunak klien.
OutBufCountHost
Jumlah buffer output pada host.
OutBufCountClient
Jumlah buffer output pada klien.
OutBufLength
Panjang buffer output, dalam byte.
KeyboardLayout
Menentukan tata letak keyboard.
MaxConnectionTime
Durasi maksimum sesi Layanan Desktop Jauh, dalam hitungan menit.
MaxDisconnectionTime
Jumlah waktu maksimum, dalam hitungan menit, bahwa sesi Layanan Desktop Jauh yang terputus tetap aktif di server Host Sesi RD.
MaxIdleTime
Jumlah waktu maksimum, dalam hitungan menit, bahwa sesi Layanan Desktop Jarak Jauh dapat tetap menganggur.
PerformanceFlags
Menentukan sekumpulan fitur yang dapat diatur di server untuk meningkatkan performa. Ini bisa menjadi kombinasi dari satu atau beberapa nilai berikut.
WRDS_PERF_DISABLE_NOTHING (0x00000000)
Tidak ada fitur yang dinonaktifkan.
WRDS_PERF_DISABLE_WALLPAPER (0x00000001)
Wallpaper pada desktop tidak ditampilkan.
WRDS_PERF_DISABLE_FULLWINDOWDRAG (0x00000002)
Seret jendela penuh dinonaktifkan; hanya kerangka jendela yang ditampilkan saat jendela dipindahkan.
WRDS_PERF_DISABLE_MENUANIMATIONS (0x00000004)
Animasi menu dinonaktifkan.
WRDS_PERF_DISABLE_THEMING (0x00000008)
Tema dinonaktifkan.
WRDS_PERF_ENABLE_ENHANCED_GRAPHICS (0x00000010)
Aktifkan grafik yang ditingkatkan.
WRDS_PERF_DISABLE_CURSOR_SHADOW (0x00000020)
Tidak ada bayangan yang ditampilkan untuk kursor.
WRDS_PERF_DISABLE_CURSORSETTINGS (0x00000040)
Kursor berkedip dinonaktifkan.
WRDS_PERF_ENABLE_FONT_SMOOTHING (0x00000080)
Aktifkan penghalusan font.
WRDS_PERF_ENABLE_DESKTOP_COMPOSITION (0x00000100)
Aktifkan komposisi desktop.
KeyboardType
Menentukan tipe keyboard.
KeyboardSubType
Menentukan subjenis keyboard.
KeyboardFunctionKey
Menentukan kunci fungsi.
ActiveInputLocale
Menentukan pengidentifikasi lokal input. Kata rendah berisi pengidentifikasi bahasa dan kata tinggi berisi handel perangkat ke tata letak fisik keyboard.
SerialNumber
Nomor seri unik komputer klien.
ClientAddressFamily
Keluarga alamat IP klien.
ClientBuildNumber
Nomor build klien.
ClientSessionId
Id sesi klien.
WorkDirectory[WTS_DIRECTORY_LENGTH + 1]
String yang berisi direktori tempat program awal berada. Nilai ini digunakan jika fInheritInitialProgram diatur ke TRUE.
InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1]
Nilai string yang menentukan nama program awal. Nilai ini digunakan jika fInheritInitialProgram diatur ke TRUE.
UserName[WTS_USERNAME_LENGTH + 1]
String yang menentukan nama pengguna. Nilai ini digunakan jika fInheritAutoLogon diatur ke TRUE.
Domain[WTS_DOMAIN_LENGTH + 1]
String yang menentukan domain pengguna. Nilai ini digunakan jika fInheritAutoLogon diatur ke TRUE.
Password[WTS_PASSWORD_LENGTH + 1]
String yang menentukan kata sandi pengguna. Nilai ini digunakan jika fInheritAutoLogon diatur ke TRUE.
ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1]
String yang berisi nama protokol.
DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1]
String yang menentukan nama driver tampilan yang akan dimuat.
DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1]
String yang menentukan nama perangkat tampilan.
imeFileName[WTS_IMEFILENAME_LENGTH + 1]
Menentukan nama editor metode input.
AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1]
String yang berisi nama driver audio yang akan dimuat.
ClientName[WTS_CLIENTNAME_LENGTH + 1]
String yang berisi nama komputer klien yang sepenuhnya memenuhi syarat.
ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1]
String yang berisi alamat IP klien dalam format desimal putus-putus.
ClientDirectory[WTS_DIRECTORY_LENGTH + 1]
Direktori klien.
String yang berisi direktori klien.
ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1]
String yang berisi pengidentifikasi produk klien.
ClientSockAddress
Struktur WRDS_SOCKADDR yang berisi informasi alamat soket.
ClientTimeZone
Struktur WRDS_TIME_ZONE_INFORMATION yang berisi informasi zona waktu klien.
WRdsListenerSettings
Struktur WRDS_LISTENER_SETTINGS yang berisi pengaturan pendengar.
EventLogActivityId
ContextSize
Ukuran, dalam byte, dari array ContextData .
ContextData
Array byte yang berisi data kontekstual untuk koneksi. Ukuran array ini ditentukan dalam anggota ContextSize .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tidak ada yang didukung |
| Server minimum yang didukung | Windows Server 2012 |
| Header | wtsdefs.h (termasuk Wtsprotocol.h) |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk