Proprietà IMsRdpExtendedSettings::P roperty
Contiene una proprietà denominata.
Questa 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 della proprietà
Valore della proprietà denominata.
| Nome proprietà | Tipo di dati | Accesso | Può essere modificato dopo l'avvio della connessione | Descrizione |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Lettura/scrittura | Sì | L'impostazione di questa proprietà su True fa sì che il controllo client si connetta 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 | Lettura/scrittura | No | Se True, le credenziali non vengono inviate al server remoto. |
| EnableFrameBufferRedirection | VT_BOOL | Lettura/scrittura | No | Se True, viene eseguito il tentativo di reindirizzamento del buffer dei 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 | Lettura/scrittura | Sì | L'impostazione di questa proprietà su True indica che 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 | Lettura/scrittura | Sì | Implementa la funzionalità Zoom usando il controllo ActiveX RDP. La funzionalità Zoom è disponibile dal menu |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | No | Se True, in questo modo le connessioni RemoteApp tornano alla barra della lingua legacy prima di Windows 8, anziché 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 del socket Hyper-V'indirizzo in cui deve essere inviato il traffico RDP. |
| DeviceScaleFactor | VT_UI4 | R/W | No | Specifica il fattore di scala 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 usato di sicurezza dell'autenticazione di Servizi Desktop remoto di Azure Active Directory. |
| 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 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 |
| 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:
Vedere la documentazione di WSLg https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Sì | La scrittura di true in questa proprietà mostra 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 |
| TSGTransportIsUsed | VT_BOOL | R | N/D | Se True, per la sessione remota associata viene usato un gateway Desktop remoto. |
| DiagnosticsInfo | VT_BSTR | W | No | Stringa esadecimale che rappresenta il campo rdpCorrelationInfo.correlationId del client X.224 Connection Request PDU. |
| EndpointFedAuth | VT_BSTR | W | No | Token usato per l'autenticazione federata basata su attestazioni RDSTLS. |
| 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 dispone della funzionalità di RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1https://zcusa.951200.xyz/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411. |
| AppContainerID | VT_BSTR | W | No | L'ID AppContainer passato a IWorkspaceScriptable3::StartWorkspaceEx2 quando viene richiamato IMsRdpClientNonScriptable8::StartWorkspaceExtension. Nota: il pannello di controllo Connessioni RemoteApp e Desktop 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://zcusa.951200.xyz/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 Connessioni RemoteApp e Desktop a cui appartiene la sessione remota. |
| ShowConnectionInformation | VT_BOOL | W | Sì | Se si scrive true in questa proprietà, viene visualizzata la finestra di dialogo Informazioni di connessione. |
| 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://zcusa.951200.xyz/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 è 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 di Hyper-V, vedere Bind to a Hyper-V socket. |
| 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ì | La scrittura di true in questa proprietà mostra 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à ShowConnectionInformation. |
| DisableAutoReconnectComponent | VT_BOOL | W | No | Se True, la connessione server non verrà disconnessa e riconnessa automaticamente quando viene modificata la configurazione di rete. Per impostazione predefinita, questa opzione è impostata su False. |
| RedirectUsbDrive | VT_UI4 | R/W | No | Introdotto in Windows 11 versione 24H2. Se non è impostata o impostata su 0, l'unità usb viene reindirizzata come direzione dell'unità. Se impostato su 1, tutte le unità USB vengono reindirizzate automaticamente come dispositivi USB. Se impostata su 2, le unità USB sono elencate come dispositivi USB, gli utenti possono scegliere di reindirizzarli tramite reindirizzamento USB dall'interfaccia utente (finestra di dialogo del dispositivo nella barra di connessione) o voce di file RDP "UsbDevicesToRedirect". |
| protocolli di sicurezza consentiti | VT_BSTR | W | No | Introdotto in Windows 11 versione 24H2. Questa proprietà viene utilizzata per limitare l'elenco dei protocolli di sicurezza che il client può negoziare. L'elenco effettivo dei protocolli negoziati è determinato da altre impostazioni di configurazione e dallo scenario di connessione e può essere inferiore all'elenco specificato in questa proprietà. Il valore deve contenere l'elenco di nomi di protocollo separati da ';' oppure il valore può essere impostato su "" , il che significa che tutti i protocolli negoziati normalmente sono consentiti. I nomi dei protocolli supportati sono: "TLS", "CredSSP", "RDSTLS" e "RDS AAD Auth" Il valore predefinito è "". |
| AllowRelativeMouseMode | VT_BOOL | R/W | No | Introdotto in Windows 11 versione 24H2. Se True, i movimenti del mouse sono rappresentati in relazione alla posizione corrente del mouse. |
| RemoteAppMouseMoveInject | VT_BOOL | W | No | Introdotto in Windows 11 versione 24H2. La scrittura di True in questa proprietà forza l'inserimento di uno spostamento del mouse quando il cursore lascia una finestra di RemoteApp. Si tratta di una soluzione alternativa per un bug di descrizione comando. |
Fabbisogno
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 8 |
| Server minimo supportato |
Windows Server 2012 |
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting è definito come 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting viene definito come A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting è definito come 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings è definito come 302D8188-0052-4807-806A-362B628F9AC5 |
Vedere anche
-
IMsRdpExtendedSettings