IRemoteDesktopClientSettings::SetRdpProperty-Methode (rdpappcontainerclient.h)

Legt den Wert einer einzelnen benannten RDP-Eigenschaft fest.

Syntax

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

Parameter

[in] propertyName

Eine Zeichenfolge, die den Namen der Eigenschaft bereitstellt.

Hinweis Bei diesen Zeichenfolgenwerten wird die Groß-/Kleinschreibung nicht beachtet.

 

Die möglichen Werte sind.

"Administrative Sitzung" (boolescher Wert)

Gibt an, ob es sich bei der Sitzung um eine Verwaltungssitzung handelt. Dies kann einer der folgenden Werte sein.

false

Die Sitzung ist keine Verwaltungssitzung.

True

Die Sitzung ist eine Verwaltungssitzung.

"Schriftglättung zulassen" (Boolescher Wert)

Gibt an, ob die Schriftartglättung in der Remotesitzung zulässig ist. Dies kann einer der folgenden Werte sein.

false

Schriftglättung ist nicht zulässig.

True

Schriftglättung ist zulässig.

"alternative vollständige Adresse" (Zeichenfolge)

Gibt einen alternativen Namen oder eine alternative IP-Adresse des Remotecomputers an, mit dem Sie eine Verbindung herstellen möchten.

"audiocapturemode" (Boolean)

Gibt den Audioeingabeaufnahmemodus an. Dies kann einer der folgenden Werte sein.

false

Erfassen Sie keine Audioeingabe.

True

Erfassen von Audioeingaben.

"audiomode" (Zahl)

Gibt an, wo Sounds wiedergegeben werden. Dies kann einer der folgenden Werte sein.

0

Wiedergeben von Sounds auf dem Clientcomputer.

1

Wiedergeben von Sounds auf dem Hostcomputer.

2

Keine Sounds wiedergeben.

"Authentifizierungsebene" (Zahl)

Gibt die Authentifizierungsebene der Remotesitzung an. Dies kann einer der folgenden Werte sein.

0

Keine.

1

Authentifizierung erforderlich.

2

Authentifizierung verhandelbar.

3

Authentifizierung nicht angegeben.

"Verbindungstyp" (Zahl)

Gibt den Verbindungstyp an. Dies kann einer der folgenden Werte sein.

1

Modem

2

Breitband mit geringer Geschwindigkeit

3

Satellit

4

Hochgeschwindigkeits-Breitband

5

WAN

6

LAN

7

Automatische Erkennung

"Cookiebasierte Authentifizierungsserveradresse" (Zeichenfolge)

Gibt die Adresse des cookiebasierten Authentifizierungsservers an.

"desktopheight" (Zahl)

Gibt die Höhe des virtuellen Desktops in Pixel an.

"desktopwidth" (Zahl)

Gibt die Breite des virtuellen Desktops in Pixel an.

"Vollständiges Fensterziehen deaktivieren" (Boolescher Wert)

Gibt an, ob das Anzeigen von Fensterinhalten beim Ziehen deaktiviert ist. Dies kann einer der folgenden Werte sein.

false

Aktiviert

True

Disabled

"Menüanims deaktivieren" (Boolescher Wert)

Gibt an, ob die Anzeige von Menüanimationen deaktiviert ist. Dies kann einer der folgenden Werte sein.

false

Aktiviert

True

Disabled

"Designs deaktivieren" (Boolescher Wert)

Gibt an, ob Designs deaktiviert sind. Dies kann einer der folgenden Werte sein.

false

Aktiviert

True

Disabled

"Hintergrundbild deaktivieren" (Boolean)

Gibt an, ob Hintergrundbilder angezeigt werden. Dies kann einer der folgenden Werte sein.

false

Hintergrundbilder werden angezeigt.

True

Hintergrundbilder werden nicht angezeigt.

"domain" (Zeichenfolge)

Gibt die Domäne an, die zum Herstellen einer Verbindung mit der Remotesitzung verwendet wird.

"enablecredsspsupport" (Boolescher Wert)

Gibt an, ob die CredSSP-basierte Authentifizierung für die Remotesitzung verwendet werden soll. Dies kann einer der folgenden Werte sein.

false

Verwenden Sie keine CredSSP-basierte Authentifizierung.

True

Verwenden Sie die CredSSP-basierte Authentifizierung.

"vollständige Adresse" (Zeichenfolge)

Gibt die Adresse des Computers an, mit dem eine Verbindung hergestellt wird.

"gatewaycredentialssource" (Zahl)

Gibt die Quelle für Anmeldeinformationen für das Remotedesktopgateway an. Dies kann einer der folgenden Werte sein.

0

Fordern Sie den Benutzer auf, seine Anmeldeinformationen einzugeben, und verwenden Sie die NTLM-Authentifizierung.

1

Verwenden Sie eine intelligente Karte für Anmeldeinformationen.

2

Verwenden Sie die Anmeldeinformationen für den aktuell angemeldeten Benutzer.

3

Fordern Sie den Benutzer auf, seine Anmeldeinformationen einzugeben, und verwenden Sie die Standardauthentifizierung.

4

Der Benutzer wählt die Anmeldeinformationsquelle bei der Anmeldung aus.

5

Verwenden Sie die cookiebasierte Authentifizierung.

"gatewayhostname" (String)

Gibt den Namen des Remotedesktopgatewayservers an.

"gatewayprofileusagemethod" (Zahl)

Gibt die Verwendung des Remotedesktopgatewayprofils an. Dies kann einer der folgenden Werte sein.

0

Verwenden Sie die Gatewayprofileinstellungen, falls vorhanden.

1

Verwenden Sie die expliziten Gatewayeinstellungen, auch wenn ein Gatewayprofil vorhanden ist.

"gatewayusagemethod" (Zahl)

Gibt die Verwendung des Remotedesktopgateways an. Dies kann einer der folgenden Werte sein.

0

Verwenden Sie keinen Remotedesktopgatewayserver. Das Kontrollkästchen RD-Gatewayserver für lokale Adressen umgehen ist deaktiviert.

1

Verwenden Sie das Remotedesktopgateway, das durch die Eigenschaft "gatewayhostname" angegeben wird.

2

Erkennen Sie automatisch die Einstellungen des Remotedesktopgatewayservers.

3

Verwenden Sie die Standardeinstellungen für die Verwendung des Remotedesktopgateways.

4

Verwenden Sie keinen Remotedesktopgatewayserver. Das Kontrollkästchen RD-Gatewayserver für lokale Adressen umgehen ist aktiviert.

"Maus mit hoher Auflösung" (boolescher Wert)

Gibt den Auflösungsmodus für die Mauseingabe an. Dies kann einer der folgenden Werte sein.

false

Die Mauseingabe wird zusammengezeigt. Mausdaten werden gemäß der Standard-Samplingrate untersampelt und gesendet.

True

Die Mauseingabe wird nicht zusammengefaktet. Mausdaten werden in voller Auflösung gesendet.

"loadbalanceinfo" (String)

Enthält das Lastenausgleichscookies, das verwendet wird, um den besten Server für den Clientcomputer auszuwählen.

"Anmeldewebseitenadresse" (Zeichenfolge)

Gibt die Adresse der Anmeldewebseite an.

"Serveradresse vor der Authentifizierung" (Zeichenfolge)

Gibt die Adresse des Vorauthentifizierungsservers an.

"Aufforderung zur Eingabe von Anmeldeinformationen" (boolescher Wert)

Gibt an, ob der Benutzer zur Eingabe seiner Anmeldeinformationen aufgefordert wird. Dies kann einer der folgenden Werte sein.

false

Der Benutzer wird nicht zur Eingabe von Anmeldeinformationen aufgefordert.

True

Der Benutzer wird zur Eingabe von Anmeldeinformationen aufgefordert.

"promptcredentialonce" (Zahl)

Gibt an, ob die Freigabe von Anmeldeinformationen für das Remotedesktopgateway aktiviert ist. Dies kann einer der folgenden Werte sein.

0

Die Freigabe von Anmeldeinformationen ist deaktiviert.

1

Die Freigabe von Anmeldeinformationen ist aktiviert.

"redirectclipboard" (Boolean)

Gibt an, ob die Zwischenablage für den Client an die Remotesitzung umgeleitet wird. Dies kann einer der folgenden Werte sein.

false

Die Zwischenablage wird nicht umgeleitet.

True

Die Zwischenablage wird umgeleitet.

"redirectprinters" (Boolean)

Gibt an, ob die Drucker für den Client an die Remotesitzung umgeleitet werden. Dies kann einer der folgenden Werte sein.

false

Die Drucker werden nicht umgeleitet.

True

Die Drucker werden umgeleitet.

"Vorauthentifizierung erforderlich" (Zahl)

Gibt an, ob eine Vorauthentifizierung erforderlich ist. Dies kann einer der folgenden Werte sein.

0

Eine Vorauthentifizierung ist nicht erforderlich.

1

Eine Vorabauthentifizierung ist erforderlich.

"Support-URL" (Zeichenfolge)

Gibt die URL an, von der Supportinformationen abgerufen werden sollen.

Boolescher Wert

"Name des Umleitungsservers verwenden" (Boolescher Wert)

Gibt an, ob ein Umleitungsserver zulässig ist. Dies kann einer der folgenden Werte sein.

false

Ein Umleitungsserver ist nicht zulässig.

True

Ein Umleitungsserver ist zulässig.

"benutzername" (Zeichenfolge)

Gibt den Benutzernamen an, der zum Herstellen einer Verbindung mit der Remotesitzung verwendet wird.

"WinRTEncryptedPassword" (String)

Gibt ein verschlüsseltes Kennwort an. Um diese Eigenschaft festzulegen, müssen Sie die folgenden Aktionen ausführen.

1. Konvertieren Sie das Klartextkennwort in binär, indem Sie die ConvertStringToBinary-Methode für die CryptographicBuffer-Klasse verwenden.
2. Legen Sie die WinRTPasswordEncoding-Eigenschaft fest, indem Sie einen entsprechenden Wert für den Codierungsparameter verwenden, den Sie in Schritt 1 an die ConvertStringToBinary-Methode übergeben haben.
3. Rufen Sie die DataProtectionProvider(String)- Methode auf, indem Sie "LOCAL=user" für die Eingabezeichenfolge übergeben.
4. Rufen Sie die ProtectAsync-Methode auf, um die binäre Zeichenfolge zu verschlüsseln, die das Kennwort enthält.
5. Konvertieren Sie das von der ProtectAsync-Methode zurückgegebene CryptographicBuffer-Objekt mithilfe der EncodeToBase64String-Methode in einen Base64-codierten Wert.
6. Legen Sie diese Eigenschaft (WinRTEncryptedPassword) mit der base64-codierten Zeichenfolge fest, die in Schritt 5 abgerufen wurde.

"WinRTPasswordEncoding" (Zahl)

Gibt den Codierungstyp an, der auf ein verschlüsseltes Kennwort angewendet werden kann. Dies kann einer der folgenden Werte sein. Der Standardwert ist 1. Diese Eigenschaft muss vor dem Festlegen der WinRTEncryptedPassword-Eigenschaft festgelegt werden.

0

UTF8

1

UTF16LE

2

UTF16BE

"Arbeitsbereichs-ID" (Zeichenfolge)

Gibt den Bezeichner des Arbeitsbereichs RemoteApp und Desktopverbindung an, in dem diese RDP-Datei veröffentlicht wurde.

[in] value

Der neue Eigenschaftswert.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	rdpappcontainerclient.h
DLL	MsTscAx.dll

Weitere Informationen

IRemoteDesktopClientSettings