Condividi tramite


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