Aracılığıyla paylaş

IMsRdpExtendedSettings::P roperty özelliği

  • Makale

Adlandırılmış bir özellik içerir.

Bu özellik okuma/yazma özelliğidir.

Sözdizimi

HRESULT put_Property(
  [in]          BSTR    bstrPropertyName,
  [in]          VARIANT *pValue
);

HRESULT get_Property(
  [in]          BSTR    bstrPropertyName,
  [out, retval] VARIANT *pValue
);

Özellik değeri

Adlandırılmış özellik değeri.

Özellik adı Veri tipi Erişim Bağlantı başlatıldıktan sonra değiştirilebilir Açıklama
ConnectToChildSession VT_BOOL Okuma/Yazma Evet Bu özelliğin True olarak ayarlanması, istemci denetiminin uzak sunucu yerine yerel makinedeki alt oturuma bağlanmasına neden olur. Bu özellik trueolarak ayarlanırsa, tüm bağlantılar localhost'a yönlendirildiğinden uzak sunucuya bağlanamazsınız. Alt oturumlar hakkında daha fazla bilgi için bkz. Alt Oturumlar.
DisableCredentialsDelegation VT_BOOL Okuma/Yazma Hayır Truekimlik bilgileri uzak sunucuya gönderilmez.
EnableFrameBufferRedirection VT_BOOL Okuma/Yazma Hayır Trueçerçeve arabelleği yeniden yönlendirmesi denendi. Geri döngü bağlantısı için (aynı bilgisayar hem istemci hem de sunucudur) çerçeve arabelleği yeniden yönlendirmesi, çerçeve arabelleği belleğinin oturumlar arasında paylaşılmasını sağlar.
EnableHardwareMode VT_BOOL Yalnızca Yaz Hayır True, grafik kod çözme ile ilgili donanım yardımı denendi.
IgnoreCursors VT_BOOL Yalnızca Yaz Hayır Trueuzak sunucu tarafından gönderilen imleçler yoksayılır.
ManualClipboardSyncEnabled VT_BOOL Okuma/Yazma Evet Bu özelliğin True olarak ayarlanması, yerel ve uzak panoların otomatik olarak eşitlenmemesi anlamına gelir. Bunun yerine IMsRdpClipboard arabirimi, pano biçimlerini yerel panodan uzak panoya ve uzak panoyu yerel panoya eşitlemek için kullanılmalıdır.
ZoomLevel * VT_UI4 Okuma/Yazma Evet RDP ActiveX denetimini kullanarak Yakınlaştırma özelliğini uygular. Yakınlaştırma özelliği RDP'nin Sistem menüsünden kullanılabilir. ZoomLevel özelliğinin RemoteApp modunda ve tam ekran modunda hiçbir etkisi yoktur. IMsRdpClientAdvancedSettings::SmartSizing ve ZoomLevel birbirini dışlar.
DisableSeamlessLanguageBar VT_BOOL R/W Hayır Truebu, RemoteApp bağlantılarının yerel dili uzak oturumla otomatik olarak eşitlemek yerine Windows 8'den önceki eski dil çubuğuna geri dönmelerine neden olur. 
RedirectTextProcessing VT_BOOL W Hayır Windows 11 23H2'den başlayarak, metin girişi senaryoları (IME, ifadeler gibi) için yerel bir deneyim sağlayan metin işlemenin yeniden yönlendirilmesini etkinleştirir/devre dışı bırakır. 
HvSocketServiceId VT_BSTR W Hayır RDP trafiğinin gönderileceği Hyper-V yuvaadresinin ServiceId alanını belirtir. 
DeviceScaleFactor VT_UI4 R/W Hayır Uzak oturumda kullanılan cihaz ölçek faktörü belirtir.
Geçerli değerler: 100, 140, 180
EnableLocationRedirection VT_BOOL R/W Hayır Yerel makinenin konumunun uzak oturuma yeniden yönlendirilmesini etkinleştirir/devre dışı bırakır. 
AudioCaptureDevice VT_BSTR R/W Hayır İstemciden uzak oturuma yönlendirilecek ses yakalama cihazının cihaz kimliğini belirtir.
Uygulamalar, yeniden yönlendirilecek ses yakalama cihazının cihaz kimliğini belirlemek için DRV_QUERYFUNCTIONINSTANCEID iletisini kullanabilir.
Alternatif olarak, bu varsayılan cihazı kullanmak için "varsayılan" veya ses yakalamayı devre dışı bırakmak için ""yok"" olarak ayarlanabilir. Varsayılan olarak, bu "varsayılan" olarak ayarlanır.
RailMode VT_BOOL R Hayır Bunun bir RemoteApp bağlantısı olup olmadığını bildirir. ITSRemoteProgram::RemoteProgramMode bu özelliğe yazar . 
EnableRdsAadAuth VT_BOOL W Hayır TrueRDS AAD Kimlik Doğrulama Güvenliği kullanılır. 
RDGIsKDCProxy VT_BOOL W Hayır True, istemciyeKDC Proxy sunucusu olarak RD Ağ Geçidi (belirtildiyse) kullanmasını söyler. 
UseURCP VT_BOOL R/W Hayır Truebu özellik UDP tabanlı Uzak Masaüstü bağlantıları için Evrensel Hız Denetimi Protokolü'nü etkinleştirir. Şu anda varsayılan olarak devre dışıdır. UDP kullanılıyorsa etkinleştirmeniz önerilir. 
DesktopScaleFactor VT_UI4 R/W Hayır Uzak oturumda kullanılan cihaz ölçek faktörü belirtir. Değer 100 ile 500 (yüzde) arasında olmalıdır. 
RedirectedAuthentication VT_BOOL W Hayır TrueUzak Credential Guard etkinleştirilir. 
RestrictedLogon VT_BOOL W Hayır TrueKısıtlı Yönetici modu etkinleştirilir. 
AudioPlaybackDevice VT_BSTR R/W Hayır Yerel makinedeki ses kayıttan yürütme cihazının cihaz kimliğini belirtir.
Uygulamalar, yeniden yönlendirilecek ses kayıttan yürütme cihazının cihaz kimliğini belirlemek için DRV_QUERYFUNCTIONINSTANCEID iletisini kullanabilir.
"Alternatif olarak, bu varsayılan cihazı kullanmak için ""varsayılan"" olarak veya ses kayıttan yürütmeyi devre dışı bırakmak için ""yok"" olarak ayarlanabilir. Varsayılan olarak, bu ""default"" olarak ayarlanır. "
SelectedMonitors VT_BSTR R/W Hayır Uzak oturumun görüntüleneceği seçili izleyicileri tanımlamak için virgülle ayrılmış veya yarı sütunlu bir izleyici kimliği listesi. Listedeki ilk kimlik, uzak oturumda birincil izleyici olarak değerlendirilir. 
WslgModeEnabled VT_BOOL W Hayır Trueoturum bir WSLg oturumudur.
Aşağıdaki özelliklerin sağlanması beklenir:
  • WslgSharedMemoryPath
  • HvSocketEnabled
  • HvSocketServiceId

WSLg'nin https://github.com/microsoft/wslgbelgelerine bakın.
ShowSessionDiagnostics VT_BOOL W Evet Bu özelliğe True yazıldığında, uzak oturum hakkında ayrıntılı bilgilerin yer alan bir iletişim kutusu hemen gösterilir.
Bu özelliğin bir hata ayıklama mekanizması olması amaçlanır. Değiştirilebilir ve kaldırılmaya tabidir. 
PrintingProgressMode VT_UI4 R/W Hayır Olası değerler:
  • 0: Yazdırma devre dışı bırakıldığında gösterilen ilerleme durumu iletişim kutusu
  • 1: Yazdırma işlemi temel bilgiler içerirken gösterilen ilerleme durumu iletişim kutusu
  • 2: Yazdırma işlemi ayrıntılı bilgiler içerirken gösterilen ilerleme durumu iletişim kutusu
CorrelationId VT_BOOL W Hayır IMsRdpClientNonScriptable8::CorrelationId tarafından döndürülen değeri geçersiz kılar. 
RequestUseNewOutputPresenter VT_BOOL W Hayır Trueuzak oturum yalnızca DirectX kullanılarak GDI'ya geri dönüş olmadan sunulur. Bu özellik uzak uygulama oturumları için geçerli değildir.
Not: Yalnızca DirectX modu tek kullanılabilir seçenek haline gelebileceğinden, bu özellik Windows'un gelecek sürümlerinde kaldırılmaya tabidir. Bu, şu anda üretim kodunda etkinleştirilmemesi gereken bir önizleme özelliğidir.
GatewayCertificateLogonAuthority VT_BSTR W Hayır Bu özellik artık desteklenmiyor. Windows'un gelecek sürümlerinde kaldırılmaya tabidir. Bu özelliği kullanmayın. 
EnableRemoteEdgeBar VT_BOOL R/W Hayır True ve ServerSupportsEdgeActions özelliği Trueise, uzak oturumun bağlantı araç çubuğunda ek komutlar gösterilir. 
TSGTransportIsUsed VT_BOOL R YOK True, ilişkili uzak oturum için bir Uzak Masaüstü ağ geçidi kullanılır. 
DiagnosticsInfo VT_BSTR W Hayır İstemci X.224 Bağlantı İsteği PDUrdpCorrelationInfo.correlationId alanını temsil eden onaltılık dize. 
EndpointFedAuth VT_BSTR W Hayır talep tabanlı federasyon RDSTLS kimlik doğrulamasıiçin kullanılan belirteç. 
AllowAxToContainerEvents VT_BOOL W Hayır Bu özellik Windows 11 22H2'ye eklendi.
  • False (Windows 11 22H2'de başlayan varsayılan davranış), CTRL+ALT+OK tuş bileşimleri uzak oturuma gönderilir.
  • True (Windows 11 22H2'den önceki varsayılan davranış), CTRL+ALT+ARROW tuş bileşimleri uygulamaya bir IMsTscAxEvents::OnFocusReleased olayı oluşturur.
ServerSupportsEdgeActions VT_BOOL R YOK Uzak oturumun https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 özelliğine sahip olup olmadığını belirlemek için salt okunur özellik. 
AppContainerID VT_BSTR W Hayır IMsRdpClientNonScriptable8::StartWorkspaceExtension çağrıldığında AppContainer Kimliği IWorkspaceScriptable3::StartWorkspaceEx2 geçirildi.
Not: RemoteApp ve Masaüstü Bağlantıları denetim masası artık etkin geliştirme aşamasında değildir. Windows'un gelecek sürümlerinde değiştirilebilir veya kullanılamayabilir. Bu API'nin kullanımı önerilmez.
IgnoreServerGeneratedMouseMoves VT_BOOL R/W Hayır Trueuzak oturumda program aracılığıyla oluşturulan fare hareketi yoksayılır. Daha kesin olarak, İşaretçi Konumu Güncelleştirme PDU'sunun uygulanmaması. Bkz. https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. 
RDmiDiagnosticsUrl VT_BSTR W Hayır Bu özellik artık desteklenmiyor. Windows'un gelecek sürümlerinde kaldırılmaya tabidir. Bu özelliği kullanmayın. 
EnableVailMonitorConfig VT_BOOL R/W Hayır True, görüntü yapılandırmaları eşitlenirken uzak oturuma genişletilmiş monitör bilgileri (ör. EDID'ler) gönderilir. 
Çalışma Alanı Kimliği VT_BSTR W Hayır Uzak oturumun ait olduğu RemoteApp ve Masaüstü Bağlantıları'ndaki bağlantının benzersiz tanımlayıcısı. 
ShowConnectionInformation VT_BOOL W Evet Bu özelliğe True yazarken Bağlantı Bilgileri iletişim kutusu gösterilir. 
WslgSharedMemoryPath VT_BSTR W Hayır WSLg sanal makinesiyle grafik arabelleği paylaşmak için bellek oturumu nesnesinin yolu. 
HiDefRemoteAppContainerGUID VT_BSTR W Hayır Uzak uygulamayı barındıran çalışan VM ile ilişkili GUID. Bu özelliğin yazılması, bellek paylaşımı nedeniyle yerel bir VM'de çalışan uzak uygulamaların performansının artmasına neden olur. 
KDCProxyName VT_BSTR W Hayır "Anahtar Dağıtım Merkezi (KDC) Proxy sunucusunun tam etki alanı adını belirtir. KDC Ara Sunucusu, RDP istemcisinin KDC'ye doğrudan erişemediğinde Kerberos kimlik doğrulama protokollerini kullanmasına izin verir.  Özellik değeri örneği: ""kdc.contoso.com"". Daha fazla bilgi için bkz. Kerberos Anahtar Dağıtım Merkezi ara sunucusuyapılandırma , https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38
DisableTouchRemoting VT_BOOL R/W Hayır True, çok dokunmatik ekranlardaki hareketler uzak sunucuya gönderilmez. Varsayılan olarak, falseolarak ayarlanır. 
HvSocketEnabled VT_BOOL W Hayır Trueuzak sunucunun adı ,GUID ise, RDP trafiğinin gönderileceği Hyper-V yuva adresinin VmId alanı olarak yorumlanır. Varsayılan olarak, falseolarak ayarlanır.
Hyper-V yuva adresleri hakkında daha fazla bilgi için bkz. Hyper-V yuvaya bağlama. 
MultipenRemotingSupported VT_BOOL W Hayır Trueise, uzak oturumda en fazla dört kalem cihazından aynı anda giriş eklenmesi desteklenir. Varsayılan olarak, falseolarak ayarlanır. 
ShowGatewayInformation VT_BOOL W Evet Bu özelliğe True yazılırken, Uzak Masaüstü ağ geçidi hakkındaki bilgileri gösteren bir iletişim kutusu gösterilir.
Windows 11 22H2 ve üzeri: Bu özellik artık desteklenmiyor ve ShowConnectionInformation özelliğiyle değiştirildi.
DisableAutoReconnectComponent VT_BOOL W Hayır True, ağ yapılandırması değiştirildiğinde sunucu bağlantısı kesilmez ve otomatik olarak yeniden bağlanmaz. Varsayılan olarak, falseolarak ayarlanır.
RedirectUsbDrive VT_UI4 R/W Hayır Windows 11 sürüm 24H2'de kullanıma sunulmuştur. Ayarlanmadığında veya 0 olarak ayarlanmadığında, USB başparmak sürücüsü sürücü yönü olarak yeniden yönlendirir. 1 olarak ayarlandığında, tüm USB başparmak sürücüleri otomatik olarak USB cihazları olarak yeniden yönlendirilir. 2 olarak ayarlandığında, USB başparmak sürücüleri USB cihazları olarak listelenir, kullanıcılar kullanıcı arabiriminden (bağlantı çubuğundaki cihaz iletişim kutusu) veya "UsbDevicesToRedirect" RDP dosya girdisinden USB yeniden yönlendirmesi aracılığıyla bunları yeniden yönlendirmeyi seçebilir.
izin verilen güvenlik protokolleri VT_BSTR W Hayır Windows 11 sürüm 24H2'de kullanıma sunulmuştur. Bu özellik, istemcinin anlaşabileceği güvenlik protokollerinin listesini kısıtlamak için kullanılır. Üzerinde anlaşmaya varılan protokollerin gerçek listesi diğer yapılandırma ayarları ve bağlantı senaryosu tarafından belirlenir ve bu özellikte belirtilen listeden daha küçük olabilir. Değerin ';' ile ayrılmış protokol adlarının listesini içermesi gerekir veya değer "" olarak ayarlanabilir; bu da normalde anlaşmaya varılan tüm protokollere izin verileceği anlamına gelir. Desteklenen protokol adları şunlardır: "TLS", "CredSSP", "RDSTLS" ve "RDS AAD Kimlik Doğrulaması" Varsayılan değer "".
AllowRelativeMouseMode VT_BOOL R/W Hayır Windows 11 sürüm 24H2'de kullanıma sunulmuştur. True ise, fare hareketleri geçerli fare konumuna göre temsil edilir.
RemoteAppMouseMoveInject VT_BOOL W Hayır Windows 11 sürüm 24H2'de kullanıma sunulmuştur. Bu özelliğe True yazıldığında, imleç RemoteApp penceresinden ayrıldığında fare hareketi eklenmesi zorlar. Bu, bir araç ipucu hatası için geçici bir çözüm olarak tasarlanmıştır.

Gereksinim -leri

Gereksinim Değer
Desteklenen en düşük istemci
 Windows 8
Desteklenen en düşük sunucu
 Windows Server 2012
Tür kitaplığı
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
 CLSID_MsRdpClient7NotSafeForScripting 54d38bf7-b1ef-4479-9674-1bd6ea465258 olarak tanımlanır
CLSID_MsRdpClient8NotSafeForScripting A3BC03A0-041D-42E3-AD22-882B7865C9C5 olarak tanımlanır
CLSID_MsRdpClient9NotSafeForScripting 8B918B82-7985-4C24-89DF-C33AD2BBFBCD olarak tanımlanır
IID
 IID_IMsRdpExtendedSettings 302D8188-0052-4807-806A-362B628F9AC5 olarak tanımlanır

Ayrıca bkz.

IMsRdpExtendedSettings