Metodo IRemoteDesktopClientSettings::SetRdpProperty (rdpappcontainerclient.h)

Imposta il valore di una singola proprietà RDP denominata.

Sintassi

HRESULT SetRdpProperty(
  [in] BSTR    propertyName,
  [in] VARIANT value
);

Parametri

[in] propertyName

Stringa che specifica il nome della proprietà.

Nota Questi valori stringa non sono distinzione tra maiuscole e minuscole.

 

I valori possibili sono.

"sessione amministrativa" (booleano)

Specifica se la sessione è una sessione amministrativa. Questo può essere uno dei valori seguenti.

false

La sessione non è una sessione amministrativa.

Vero

La sessione è una sessione amministrativa.

"allow font smoothing" (Boolean)

Specifica se l'smoothing del tipo di carattere è consentito nella sessione remota. Questo può essere uno dei valori seguenti.

false

Non è consentito lo smoothing del tipo di carattere.

Vero

L'smoothing del tipo di carattere è consentito.

"Indirizzo completo alternativo" (String)

Specifica un nome alternativo o un indirizzo IP del computer remoto a cui si vuole connettersi.

"audiocapturemode" (booleano)

Specifica la modalità di acquisizione dell'input audio. Questo può essere uno dei valori seguenti.

false

Non acquisire l'input audio.

Vero

Acquisire l'input audio.

"audiomode" (Numero)

Specifica dove vengono riprodotti i suoni. Questo può essere uno dei valori seguenti.

0

Riprodurre suoni nel computer client.

1

Riprodurre suoni nel computer host.

2

Non riprodurre suoni.

"livello di autenticazione" (numero)

Specifica il livello di autenticazione della sessione remota. Questo può essere uno dei valori seguenti.

0

Nessuno.

1

Autenticazione obbligatoria.

2

Autenticazione negoziabile.

3

Autenticazione non specificata.

"tipo di connessione" (Numero)

Specifica il tipo di connessione Che può essere uno dei valori seguenti.

1

Modem

2

Banda larga a bassa velocità

3

Satellite

4

Banda larga ad alta velocità

5

WAN

6

LAN

7

Rilevamento automatico

"indirizzo del server di autenticazione basato su cookie" (String)

Specifica l'indirizzo del server di autenticazione basato su cookie.

"desktopheight" (Numero)

Specifica l'altezza, in pixel, del desktop virtuale.

"desktopwidth" (Numero)

Specifica la larghezza, in pixel, del desktop virtuale.

"disabilita il trascinamento della finestra completa" (booleano)

Specifica se la visualizzazione del contenuto della finestra durante il trascinamento è disabilitata. Questo può essere uno dei valori seguenti.

false

Attivato

Vero

Disabled

"disable menu anims" (booleano)

Specifica se la visualizzazione delle animazioni dei menu è disabilitata. Questo può essere uno dei valori seguenti.

false

Attivato

Vero

Disabled

"disabilita temi" (booleano)

Specifica se i temi sono disabilitati. Questo può essere uno dei valori seguenti.

false

Attivato

Vero

Disabled

"disabilita sfondo" (booleano)

Specifica se vengono visualizzati gli sfondi. Questo può essere uno dei valori seguenti.

false

Gli sfondi vengono visualizzati.

Vero

Gli sfondi non vengono visualizzati.

"domain" (String)

Specifica il dominio usato per connettersi alla sessione remota.

"enablecredsspsupport" (booleano)

Specifica se usare l'autenticazione basata su CredSSP per la sessione remota. Questo può essere uno dei valori seguenti.

false

Non usare l'autenticazione basata su CredSSP.

Vero

Usare l'autenticazione basata su CredSSP.

"indirizzo completo" (String)

Specifica l'indirizzo del computer connesso.

"gatewaycredentialssource" (Numero)

Specifica l'origine per le credenziali per il gateway Desktop remoto. Questo può essere uno dei valori seguenti.

0

Richiedere all'utente le credenziali e usare l'autenticazione NTLM.

1

Usare una smart card per le credenziali.

2

Usare le credenziali per l'utente attualmente connesso.

3

Richiedere all'utente le credenziali e usare l'autenticazione di base.

4

L'utente selezionerà l'origine delle credenziali all'accesso.

5

Usare l'autenticazione basata su cookie.

"gatewayhostname" (String)

Specifica il nome del server del gateway Desktop remoto.

"gatewayprofileusagemethod" (Numero)

Specifica l'utilizzo del profilo del gateway Desktop remoto. Questo può essere uno dei valori seguenti.

0

Se presente, usare le impostazioni del profilo del gateway.

1

Usare le impostazioni del gateway esplicite, anche se esiste un profilo gateway.

"gatewayusagemethod" (Numero)

Specifica l'utilizzo del gateway Desktop remoto. Questo può essere uno dei valori seguenti.

0

Non usare un server gateway Desktop remoto. La casella di controllo Ignora il server gateway Desktop remoto per gli indirizzi locali è deselezionata.

1

Usare il gateway Desktop remoto specificato dalla proprietà "gatewayhostname".

2

Rilevare automaticamente le impostazioni del server del gateway Desktop remoto.

3

Usare le impostazioni predefinite dell'utilizzo del gateway Desktop remoto.

4

Non usare un server gateway Desktop remoto. È selezionata la casella di controllo Ignora server gateway Desktop remoto per indirizzi locali .

"mouse ad alta risoluzione" (booleano)

Specifica la modalità di risoluzione per l'input del mouse. Questo può essere uno dei valori seguenti.

false

L'input del mouse verrà unito. I dati del mouse verranno sottocampionati e inviati in base alla frequenza di campionamento predefinita.

Vero

L'input del mouse non verrà unito. I dati del mouse verranno inviati a risoluzione completa.

"loadbalanceinfo" (String)

Contiene il cookie di bilanciamento del carico usato per scegliere il server migliore per il computer client.

"account di accesso indirizzo pagina Web" (String)

Specifica l'indirizzo della pagina Web di accesso.

"Indirizzo del server di pre-autenticazione" (String)

Specifica l'indirizzo del server di preutenticazione.

"prompt delle credenziali" (booleano)

Specifica se l'utente verrà richiesto per le proprie credenziali. Questo può essere uno dei valori seguenti.

false

L'utente non verrà richiesto di specificare le credenziali.

Vero

Verrà richiesto all'utente di specificare le credenziali.

"promptcredentialonce" (Numero)

Specifica se la condivisione delle credenziali per il gateway Desktop remoto è abilitata. Questo può essere uno dei valori seguenti.

0

La condivisione delle credenziali è disabilitata.

1

La condivisione delle credenziali è abilitata.

"redirectclipboard" (booleano)

Specifica se gli Appunti per il client vengono reindirizzati alla sessione remota. Questo può essere uno dei valori seguenti.

false

Gli Appunti non vengono reindirizzati.

Vero

Gli Appunti vengono reindirizzati.

"redirectprinters" (booleano)

Specifica se le stampanti per il client vengono reindirizzate alla sessione remota. Questo può essere uno dei valori seguenti.

false

Le stampanti non vengono reindirizzate.

Vero

Le stampanti vengono reindirizzate.

"richiedi l'autenticazione preliminare" (Numero)

Specifica se è necessaria la preutenticazione. Questo può essere uno dei valori seguenti.

0

La preautenticazione non è necessaria.

1

È necessaria la preautenticazione.

"support url" (String)

Specifica l'URL da cui ottenere informazioni di supporto.

Boolean

"use redirection server name" (Boolean)

Specifica se è consentito un server di reindirizzamento. Può trattarsi di uno dei valori seguenti.

false

Un server di reindirizzamento non è consentito.

Vero

È consentito un server di reindirizzamento.

"username" (String)

Specifica il nome utente utilizzato per connettersi alla sessione remota.

"WinRTEncryptedPassword" (String)

Specifica una password crittografata. Per impostare questa proprietà, è necessario eseguire le azioni seguenti.

1. Convertire la password di testo non crittografato in binario usando il metodo ConvertStringToBinary nella classe CryptographicBuffer .
2. Impostare la proprietà WinRTPasswordEncoding usando un valore equivalente per il parametro di codifica passato al metodo ConvertStringToBinary nel passaggio 1.
3. Chiamare il metodo DataProtectionProvider(String) passando "LOCAL=user" per la stringa di input.
4. Chiamare il metodo ProtectAsync per crittografare la stringa binaria contenente la password.
5. Convertire l'oggetto CryptographicBuffer restituito dal metodo ProtectAsync in un valore con codifica Base64 usando il metodo EncodeToBase64String .
6. Impostare questa proprietà (WinRTEncryptedPassword) con la stringa con codifica Base64 ottenuta nel passaggio 5.

"WinRTPasswordEncoding" (Numero)

Specifica il tipo di codifica che può essere applicato a una password crittografata. Può trattarsi di uno dei valori seguenti. Il valore predefinito è 1. Questa proprietà deve essere impostata prima di impostare la proprietà WinRTEncryptedPassword .

0

UTF8

1

UTF16LE

2

UTF16BE

"ID area di lavoro" (stringa)

Specifica l'identificatore dell'area di lavoro Connessione Desktop e RemoteApp pubblicata come parte di questo file RDP.

[in] value

Nuovo valore della proprietà.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	rdpappcontainerclient.h
DLL	MsTscAx.dll

Vedi anche

IRemoteDesktopClientSettings