Proprietà IMsRdpExtended Impostazioni::P roperty

Contiene una proprietà denominata.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

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

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

Valore proprietà

Valore della proprietà denominata.

Nome proprietà	Tipo di dati	Accesso	Può essere modificato dopo l'avvio della connessione	Descrizione
Connessione ToChildSession	VT_BOOL	Leggi/Scrivi	Sì	Se si imposta questa proprietà su True , il controllo client viene connesso alla sessione figlio nel computer locale anziché a un server remoto. Se questa proprietà è impostata su true, non è possibile connettersi a un server remoto perché tutte le connessioni vengono reindirizzate a localhost. Per altre informazioni sulle sessioni figlio, vedere Sessioni figlio.
DisableCredentialsDelegation	VT_BOOL	Leggi/Scrivi	No	Se True, le credenziali non vengono inviate al server remoto.
EnableFrameBufferRedirection	VT_BOOL	Leggi/Scrivi	No	Se True, viene eseguito un tentativo di reindirizzamento del buffer di frame. Per una connessione loopback (lo stesso computer è sia client che server) il reindirizzamento del buffer dei frame consente di condividere la memoria per il buffer di frame tra le sessioni.
EnableHardwareMode	VT_BOOL	Solo scrittura	No	Se True, viene eseguito un tentativo di decodifica dell'hardware con la decodifica grafica.
IgnoreCursors	VT_BOOL	Solo scrittura	No	Se True, i cursori inviati dal server remoto vengono ignorati.
ManualClipboardSyncEnabled	VT_BOOL	Leggi/Scrivi	Sì	Se si imposta questa proprietà su True , gli Appunti locali e remoti non verranno mantenuti automaticamente sincronizzati. È invece necessario usare l'interfaccia IMsRdpClipboard per sincronizzare i formati degli Appunti locali dagli Appunti locali agli Appunti remoti e agli Appunti remoti negli Appunti locali.
ZoomLevel	*VT_UI4	Leggi/Scrivi	Sì	Implementa la funzionalità Zoom usando il controllo ActiveX RDP. La funzionalità Zoom è disponibile dal menu Sistema di RDP. La proprietà ZoomLevel non ha alcun effetto in modalità RemoteApp e in modalità schermo intero. IMsRdpClientAdvanced Impostazioni::SmartSizing e ZoomLevel si escludono a vicenda.
DisableSeamlessLanguageBar	VT_BOOL	R/W	No	Se True, le connessioni RemoteApp vengono ripristinate alla barra della lingua legacy prima di Windows 8, invece di sincronizzare automaticamente la lingua locale con la sessione remota.
RedirectTextProcessing	VT_BOOL	W	No	A partire da Windows 11 23H2, abilita/disabilita il reindirizzamento dell'elaborazione del testo che offre un'esperienza simile a quella locale per gli scenari di input di testo, ad esempio IME, emoticon.
HvSocketServiceId	VT_BSTR	W	No	Specifica il campo ServiceId dell'indirizzo del socket Hyper-V in cui inviare il traffico RDP.
DeviceScaleFactor	VT_UI4	R/W	No	Specifica il fattore di scala del dispositivo usato nella sessione remota. Valori validi: 100, 140, 180
EnableLocationRedirection	VT_BOOL	R/W	No	Abilita/disabilita il reindirizzamento del percorso del computer locale alla sessione remota.
AudioCaptureDevice	VT_BSTR	R/W	No	Specifica l'ID dispositivo del dispositivo di acquisizione audio da reindirizzare dal client alla sessione remota. Le applicazioni possono usare il messaggio DRV_QUERYFUNCTIONINSTANCEID per determinare l'ID dispositivo del dispositivo di acquisizione audio da reindirizzare. In alternativa, questa opzione può essere impostata su "default" per usare il dispositivo predefinito o ""none"" per disabilitare l'acquisizione audio. Per impostazione predefinita, questa opzione è impostata su "default".
RailMode	VT_BOOL	R	No	Segnala se si tratta di una connessione RemoteApp. ITSRemoteProgram::RemoteProgramMode scrive in questa proprietà.
EnableRdsAadAuth	VT_BOOL	W	No	Se True, viene usata la sicurezza dell'autenticazione AAD di Servizi Desktop remoto.
RDGIsKDCProxy	VT_BOOL	W	No	Se True, indica al client di usare Gateway Desktop remoto (se specificato) come server proxy KDC.
UseURCP	VT_BOOL	R/W	No	Se True, questa proprietà abilita il protocollo UWP (Universal Rate Control Protocol) per le connessioni Desktop remoto basate su UDP. Attualmente, è disabilitato per impostazione predefinita. È consigliabile abilitarlo se udp è in uso.
DesktopScaleFactor	VT_UI4	R/W	No	Specifica il fattore di scala del dispositivo usato nella sessione remota. Il valore deve essere compreso tra 100 e 500 (percentuale).
RedirectedAuthentication	VT_BOOL	W	No	Se True, Remote Credential Guard è abilitato.
RestrictedLogon	VT_BOOL	W	No	Se True, la modalità Amministrazione con restrizioni è abilitata.
AudioPlaybackDevice	VT_BSTR	R/W	No	Specifica l'ID dispositivo del dispositivo di riproduzione audio nel computer locale. Le applicazioni possono usare il messaggio DRV_QUERYFUNCTIONINSTANCEID per determinare l'ID dispositivo del dispositivo di riproduzione audio da reindirizzare. "In alternativa, è possibile impostare su ""default"" per usare il dispositivo predefinito o ""none"" per disabilitare la riproduzione audio. Per impostazione predefinita, questa opzione è impostata su ""default"". "
SelectedMonitors	VT_BSTR	R/W	No	Elenco delimitato da virgole o semicolonna delimitato dall'ID di monitoraggio per identificare i monitoraggi selezionati in cui visualizzare la sessione remota. Il primo ID nell'elenco verrà considerato come il monitoraggio primario nella sessione remota.
WslgModeEnabled	VT_BOOL	W	No	Se True, la sessione è una sessione WSLg. È previsto che vengano fornite le proprietà seguenti: WslgSharedMemoryPath HvSocketEnabled HvSocketServiceId Fare riferimento alla documentazione https://github.com/microsoft/wslgdi WSLg.
ShowSessionDiagnostics	VT_BOOL	W	Sì	Se si scrive True in questa proprietà, viene visualizzata immediatamente una finestra di dialogo con informazioni dettagliate sulla sessione remota. Questa proprietà è destinata a essere un meccanismo di debug. È soggetto a modifiche e rimozione.
PrintingProgressMode	VT_UI4	R/W	No	Valori possibili: 0: finestra di dialogo di avanzamento visualizzata quando la stampa è disabilitata 1: la finestra di dialogo di avanzamento visualizzata durante la stampa contiene informazioni di base 2: la finestra di dialogo di avanzamento visualizzata durante la stampa contiene informazioni dettagliate
Correlationid	VT_BOOL	W	No	Esegue l'override del valore restituito da IMsRdpClientNonScriptable8::CorrelationId.
RequestUseNewOutputPresenter	VT_BOOL	W	No	Se True, la sessione remota viene presentata solo con DirectX senza fallback a GDI. Questa proprietà non si applica alle sessioni remote dell'app. Nota: questa proprietà è soggetta a rimozione nelle versioni future di Windows perché la modalità solo DirectX potrebbe diventare l'unica opzione disponibile. Questa è attualmente una funzionalità di anteprima che non deve essere abilitata nel codice di produzione.
GatewayCertificateLogonAuthority	VT_BSTR	W	No	Questa proprietà non è più supportata. È soggetta a rimozione nelle versioni future di Windows. Non utilizzare questa proprietà.
EnableRemoteEdgeBar	VT_BOOL	R/W	No	Se True e la proprietà ServerSupportsEdgeActions è True, nella barra degli strumenti di connessione della sessione remota vengono visualizzati altri comandi.
TSGTransportIsUsed	VT_BOOL	R	N/D	Se True, un gateway Desktop remoto è in uso per la sessione remota associata.
DiagnosticsInfo	VT_BSTR	W	No	Stringa esadecimale che rappresenta il campo rdpCorrelationInfo.correlationId del PDU richiesta client X.224 Connessione ion.
EndpointFedAuth	VT_BSTR	W	No	Token usato per l'autenticazione RDSTLS federata basata su attestazioni.
AllowAxToContainerEvents	VT_BOOL	W	No	Questa proprietà è stata aggiunta in Windows 11 22H2. Se False (comportamento predefinito a partire da Windows 11 22H2), le combinazioni di tasti CTRL+ALT+FRECCIA vengono inviate alla sessione remota. Se True (comportamento predefinito prima di Windows 11 22H2), le combinazioni di tasti CTRL+ALT+FRECCIA generano un evento IMsTscAxEvents::OnFocusReleased all'applicazione.
ServerSupportsEdgeActions	VT_BOOL	R	N/D	Proprietà di sola lettura per determinare se la sessione remota ha la funzionalità https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411di RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 .
AppContainerID	VT_BSTR	W	No	L'ID AppContainer passato a IWorkspaceScriptable3::StartWorkspaceEx2 quando viene richiamato IMsRdpClientNonScriptable8::StartWorkspaceExtension . Nota: il pannello di controllo remoteApp e Desktop Connessione ions non è più in fase di sviluppo attivo. Potrebbe essere modificato o non disponibile nelle versioni future di Windows. L'uso di questa API è sconsigliato.
IgnoreServerGeneratedMouseMoves	VT_BOOL	R/W	No	Se True, lo spostamento del mouse generato a livello di codice nella sessione remota viene ignorato. Più precisamente, il PDU dell'aggiornamento della posizione del puntatore non viene applicato. Vedere https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c.
RDmiDiagnosticsUrl	VT_BSTR	W	No	Questa proprietà non è più supportata. È soggetta a rimozione nelle versioni future di Windows. Non utilizzare questa proprietà.
EnableVailMonitorConfig	VT_BOOL	R/W	No	Se True, le informazioni di monitoraggio estese (ad esempio EDID) vengono inviate alla sessione remota durante la sincronizzazione delle configurazioni di visualizzazione.
ID area di lavoro	VT_BSTR	W	No	Identificatore univoco della connessione in RemoteApp e Desktop Connessione ions a cui appartiene la sessione remota.
Mostra Connessione ionInformation	VT_BOOL	W	Sì	Se si scrive True in questa proprietà, viene visualizzata la finestra di dialogo Informazioni Connessione ion.
WslgSharedMemoryPath	VT_BSTR	W	No	Percorso dell'oggetto sessione di memoria per condividere il buffer grafico con la macchina virtuale WSLg.
HiDefRemoteAppContainerGUID	VT_BSTR	W	No	GUID associato alla macchina virtuale in esecuzione che ospita l'applicazione remota. La scrittura di questa proprietà comporta prestazioni migliorate per le applicazioni remote in esecuzione in una macchina virtuale locale a causa della condivisione della memoria.
KDCProxyName	VT_BSTR	W	No	"Specifica il nome di dominio completo di un server proxy del Centro distribuzione chiavi (KDC). Il proxy KDC consente al client RDP di usare il protocollo di autenticazione Kerberos quando non può accedere direttamente a un KDC.  Esempio del valore della proprietà: ""kdc.contoso.com"". Per altre informazioni, vedere Configurare un proxy del Centro distribuzione chiavi Kerberos, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38
DisableTouchRemoting	VT_BOOL	R/W	No	Se True, i movimenti su schermi multitocco non verranno inviati al server remoto. Per impostazione predefinita, questa opzione è impostata su False.
HvSocketEnabled	VT_BOOL	W	No	Se True, il nome del server remoto, se si tratta di un GUID, viene interpretato come il campo VmId dell'indirizzo del socket Hyper-V in cui deve essere inviato il traffico RDP. Per impostazione predefinita, questa opzione è impostata su False. Per altre informazioni sugli indirizzi del socket Hyper-V, vedere Associare a un socket Hyper-V.
MultipenRemotingSupported	VT_BOOL	W	No	Se True, l'inserimento simultaneo dell'input da un massimo di quattro dispositivi penna è supportato nella sessione remota. Per impostazione predefinita, questa opzione è impostata su False.
ShowGatewayInformation	VT_BOOL	W	Sì	Se si scrive True in questa proprietà, viene visualizzata una finestra di dialogo che mostra informazioni sul gateway Desktop remoto. Windows 11 22H2 e versioni successive: questa proprietà non è più supportata ed è stata sostituita dalla proprietà Show Connessione ionInformation.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Libreria dei tipi	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient7NotCassaforte ForScripting è definito come 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotCassaforte ForScripting viene definito come A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotCassaforte ForScripting è definito come 8B918B82-7985-4C24-89DF-C33AD2BBFBCD
IID	IID_IMsRdpExtendedImpostazioni è definito come 302D8188-0052-4807-806A-362B628F9AC5

Vedi anche

IMsRdpExtended Impostazioni