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:
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:
|
| 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.
|
| 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 |
|
| 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 |