IRDPSRAPISessionProperties::p ut_Property-Methode (rdpencomapi.h)

Artikel
08/25/2023

Legt eine benannte Sitzungseigenschaft fest oder ruft sie ab.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_Property(
  BSTR    PropertyName,
  VARIANT newVal
);

Parameter

PropertyName

newVal

Rückgabewert

Keine

Bemerkungen

Sie können die folgenden Eigenschaften festlegen und abrufen. Bei den Eigenschaftsnamen wird die Groß-/Kleinschreibung beachtet.

Eigenschaftenname	Eigenschaftenbeschreibung	Werttyp
"DrvConAttach"	Hinweis Die DrvConAttach-Eigenschaft ist ab Windows 10 nicht mehr verfügbar. Es gibt keinen Spiegel Treiber mehr für die Freigabe. Es gibt zwei Modi für die Spiegel Treiberanlage. Der erste ist der dynamische Lademodus. In diesem Modus wird der Spiegel Treiber sofort angefügt, nachdem ein Teilnehmer mit der Sitzung verbunden ist und über die Ansichtssteuerung verfügt. Der Spiegel Treibers wird automatisch getrennt, wenn der letzte Teilnehmer die Sitzung verlässt (oder es keine Teilnehmer mit Ansichtssteuerung gibt). Der zweite Modus ist der statische Lademodus. In diesem Modus wird der Spiegel Treiber unmittelbar nach dem Öffnen der Sitzung geladen und erst entladen, wenn die Sitzung beendet wird. Beachten Sie, dass der Treiber in beiden Modi aufgrund externer Ereignisse wie dem Ändern der Bildschirmauflösung oder der Freigabe der Farbtiefe getrennt und neu angefügt wird. Legen Sie diese Eigenschaft auf VARIANT_TRUE für den dynamischen Anlagenmodus und auf VARIANT_FALSE für den statischen Anlagenmodus fest. Beachten Sie, dass Sie diese Eigenschaft nur vor dem Aufrufen der IRDPSRAPISharingSession::Open-Methode festlegen können. diese Eigenschaft wird schreibgeschützt, nachdem die Open-Methode aufgerufen wurde. Der Standardwert ist VARIANT_TRUE. Für 1:1-Szenarien wie Remoteunterstützung sollten Sie den dynamischen Lademodus verwenden, da dies zwischen dem Zeitpunkt, an dem die Sitzung geöffnet wird, und dem Moment, an dem ein Experte eine Verbindung herstellt, sehr lange dauern kann. Für Szenarien mit mehreren Parteien (1:M) sollten Sie den statischen Lademodus verwenden, da das Anfügen und Trennen des Spiegel Treibers ziemlich störend ist und nicht ausgeführt werden sollte, es sei denn, es gibt einen guten Grund.	VT_BOOL
"PortId"	Listenerport für eingehende Verbindungen vom Sharer. Diese Eigenschaft kann auch auf der Seite des Viewers festgelegt werden, wird aber nur zum Überwachen von Verbindungen im Fall einer umgekehrten Verbindung verwendet.	VT_I4
"PortProtocol"	Gibt die Protokollfamilie an, um den Listener auf dem Sharer zu starten. Die folgenden Werte sind möglich: AF_UNSPEC Wert: 0 Die Adressfamilie ist nicht angegeben. AF_INET Wert: 2 Die IPv4-Adressfamilie (Internet Protocol Version 4). AF_INET6 Wert: 23 Die IPv6-Adressfamilie (Internet Protocol Version 6).	VT_I4
"SetNetworkStream"	Ein Zeiger auf eine IUnknown-Schnittstelle , die die IRDPSRAPITransportStream-Schnittstelle unterstützt. Wenn diese Eigenschaft festgelegt ist, verwendet die Connect-Methode diesen Stream und ignoriert den übergebenen Verbindungszeichenfolge. Diese Eigenschaft ist nur für die Viewerseite gültig.	VT_UNKNOWN
"EnforceStrongEncryption"	Wenn diese Eigenschaft den Wert VARIANT_TRUE aufweist, erfordert der Sharer, dass der Viewer fips 140-kompatible Verschlüsselung verwendet. Der Standardwert ist VARIANT_FALSE. Diese Eigenschaft wird schreibgeschützt, nachdem die IRDPSRAPISharingSession::Open-Methode aufgerufen wurde. Sie können diese Eigenschaft nur festlegen, bevor Sie diese Methode aufrufen. Die Viewerunterstützung für die FIPS 140-Konformität wurde in Windows 10 Version 1709 hinzugefügt. Der Sharer lehnt Verbindungen von Viewerversionen ab, die vor Windows 10 Version 1709 verwendet wurden. Diese Eigenschaft ist nur für die Sharerseite gültig.	VT_BOOL
"FrameCaptureIntervalInMs"	Gibt das Frameerfassungsintervall an. Standardmäßig beträgt das Frameaufnahmeintervall 33 Millisekunden, was 30 Frames pro Sekunde entspricht. Sie können diese Eigenschaft verwenden, um die Leistung zu optimieren. Wenn Bildschirmupdates nicht so häufig durchgeführt werden müssen, kann das Aufzeichnungsintervall erhöht werden. Ein Wert von 400 Millisekunden ergibt beispielsweise 2,5 Frames pro Sekunde. Diese Eigenschaft ist nur für die Sharerseite gültig.	VT_I4
"DefaultAttendeeControlLevel"	Gibt die Standardsteuerungsebene für Teilnehmer an. Standardmäßig ist dieser Wert CTRL_LEVEL_NONE (keiner). Sie können diesen Wert in CTRL_LEVEL_VIEW (Ansicht) ändern. Die Standardsteuerungsebene kann nicht auf interaktiv festgelegt werden. Diese Eigenschaft ist nur für die Sharerseite gültig.	VT_I4
"EnableClipboardRedirect"	Wenn diese Eigenschaft den Wert VARIANT_TRUE hat, wird die Zwischenablage zwischen Sharer und Viewer aktiviert. Der Standardwert ist VARIANT_FALSE. Um die Zwischenablagefreigabe verwenden zu können, muss sich die Sitzung im interaktiven Modus befinden. Nur eine einzelne Verbindung kann die Zwischenablage gemeinsam nutzen. Die Verbindung, die zuletzt die Eingabesteuerung erworben hat, übernimmt die Zwischenablagefreigabe. Die Freigabe der Zwischenablage für jede vorherige Verbindung wird automatisch deaktiviert. Diese Eigenschaft kann nur für Desktop-Apps verwendet werden. Diese Eigenschaft ist nur für die Sharerseite gültig. Diese Eigenschaft ist ab Windows 10 Version 1511 verfügbar.	VT_BOOL
"SetClipboardRedirectCallback"	Gibt einen IUnknown-Zeiger auf einen instance von IRDPSRAPIClipboardUseEvents an, der jedes Mal einen Rückruf empfängt, wenn ein Kopierversuch vom Freigabecomputer in den Viewer versucht wird. Diese Eigenschaft ist nur relevant, wenn die Freigabe der Zwischenablage aktiviert ist. Diese Eigenschaft wird schreibgeschützt, nachdem die IRDPSRAPISharingSession::Open-Methode aufgerufen wurde. Sie können diese Eigenschaft nur festlegen, bevor Sie diese Methode aufrufen. Diese Eigenschaft kann nur für Desktop-Apps verwendet werden. Diese Eigenschaft ist nur für die Sharerseite gültig. Diese Eigenschaft ist ab Windows 10 Version 1511 verfügbar.	VT_UNKNOWN
"EnabledTransports"	Gibt die zu aktivierenden Transporte an. Der Wert 3 unterstützt sowohl TCP als auch UDP. Der Standardwert ist 1. Dabei handelt es sich nur um TCP. Diese Eigenschaft wird schreibgeschützt, nachdem die IRDPSRAPISharingSession::Open-Methode aufgerufen wurde. Sie können diese Eigenschaft nur festlegen, bevor Sie diese Methode aufrufen. Diese Eigenschaft ist ab Windows 10 Version 1803 verfügbar. Diese Eigenschaft ist nur für die Sharerseite gültig.	VT_I4

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	rdpencomapi.h
DLL	RdpEncom.dll

Weitere Informationen

IRDPSRAPISessionProperties

Freigeben über