IRDPSRAPISessionProperties::get_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 get_Property(
  BSTR    PropertyName,
  VARIANT *pVal
);

Parameter

PropertyName

pVal

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 Treiber 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 Farbtiefe getrennt und erneut angefügt wird. Legen Sie diese Eigenschaft für den dynamischen Anlagenmodus auf VARIANT_TRUE und für den statischen Anlagenmodus auf VARIANT_FALSE 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 es sehr lange dauern kann, bis die Sitzung geöffnet wird, und dem Moment, an dem ein Experte eine Verbindung herstellt. Bei Szenarien mit mehreren Teilnehmern (1:M) sollten Sie den statischen Lademodus verwenden, da das Anfügen und Trennen des Spiegel Treibers ziemlich störend ist und nicht durchgeführt werden sollte, es sei denn, es gibt einen guten Grund.	VT_BOOL
"PortId"	Listenerport für eingehende Verbindungen von Sharer. Diese Eigenschaft kann auch auf der Viewerseite festgelegt werden, wird aber nur zum Lauschen auf Verbindungen im Falle einer umgekehrten Verbindung verwendet.	VT_I4
"PortProtocol"	Gibt die Protokollfamilie an, um den Listener auf 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 die übergebene Verbindungszeichenfolge. Diese Eigenschaft ist nur für die Viewerseite gültig.	VT_UNKNOWN
"EnforceStrongEncryption"	Wenn diese Eigenschaft den Wert VARIANT_TRUE hat, muss der Viewer fips 140-konforme Verschlüsselung verwenden. 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 Viewer-Unterstützung für die FIPS 140-Konformität wurde in Windows 10 Version 1709 hinzugefügt. Der Sharer lehnt Verbindungen von Viewerversionen vor Windows 10, Version 1709, ab. Diese Eigenschaft ist nur für die Freigabeseite gültig.	VT_BOOL
"FrameCaptureIntervalInMs"	Gibt das Frameaufnahmeintervall 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 Erfassungsintervall erhöht werden. Beispielsweise ergibt ein Wert von 400 Millisekunden 2,5 Frames pro Sekunde. Diese Eigenschaft ist nur für die Freigabeseite gültig.	VT_I4
"DefaultAttendeeControlLevel"	Gibt die Standardsteuerungsebene für Teilnehmer an. Standardmäßig ist dieser Wert CTRL_LEVEL_NONE (none). 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 Freigabeseite 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 Freigabe der Zwischenablage 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 abgerufen hat, übernimmt die Freigabe der Zwischenablage. 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 Freigabeseite gültig. Diese Eigenschaft ist ab Windows 10 Version 1511 verfügbar.	VT_BOOL
"SetClipboardRedirectCallback"	Gibt einen IUnknown-Zeiger auf eine instance von IRDPSRAPIClipboardUseEvents an, die 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 Freigabeseite 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