IRDPSRAPISessionProperties：:p ut_Property 方法 (rdpencomapi.h)
設定或取得具名會話屬性。
這是可讀寫的屬性。
語法
HRESULT put_Property(
BSTR PropertyName,
VARIANT newVal
);
參數
PropertyName
newVal
傳回值
無
備註
您可以設定並取得下列屬性。 屬性名稱會區分大小寫。
| 屬性名稱 | 屬性描述 | 值類型 |
|---|---|---|
| “DrvConAttach” |
注意DrvConAttach 屬性已不再可供 Windows 10 使用。 不再有 鏡像驅動程式 可供共用。
第二個模式是靜態載入模式。 在此模式中，鏡像驅動程式會在會話開啟之後立即載入，而且在會話終止之前不會卸除。 請注意，在這兩種模式中，驅動程式可能會因為外部事件而中斷連結，例如變更螢幕解析度或共用色彩深度。 將此屬性設定為動態附件模式的VARIANT_TRUE，以及靜態附件模式的VARIANT_FALSE。 請注意，您只能在呼叫 IRDPSRAPISharingSession：：Open 方法之前設定此屬性;呼叫 Open 方法之後，這個屬性會變成唯讀。 預設值為 VARIANT_TRUE。 針對 1：1 的案例，例如遠端協助，您應該使用動態載入模式，因為在開啟會話和專家連線時，可能需要很長的時間。 對於 1：M (多部分) 案例，您應該使用靜態載入模式，因為連結和中斷連結鏡像驅動程式相當具干擾性，除非有好的理由，否則不應該完成。 |
VT_BOOL |
| “PortId” | 來自共用者的連入連線接聽程式埠。 這個屬性也可以設定在查看器端，但只有在反向連線時，才會用於接聽連線。 | VT_I4 |
| “PortProtocol” | 指定要在共用端啟動接聽程式的通訊協定系列。 可能的值如下： | VT_I4 |
| “SetNetworkStream” |
支援 IRDPSRAPITransportStream 介面之 IUnknown 介面的指標。 如果設定此屬性，Connect 方法會使用此數據流，並忽略傳遞的 連接字串。
此屬性僅適用於查看器端。 |
VT_UNKNOWN |
| “EnforceStrongEncryption” |
如果此屬性的值為 VARIANT_TRUE，則共用者會要求查看器使用美國聯邦資訊處理標準 (FIPS) 140 相容的加密。 預設值為 VARIANT_FALSE。
呼叫 IRDPSRAPISharingSession：：Open 方法之後，這個屬性會變成唯讀。 您只能在呼叫該方法之前設定這個屬性。 FIPS 140 合規性的查看器支援已新增至 Windows 10 1709 版。 共用者會拒絕從先前 Windows 10 版本 1709 的查看器版本連線。 此屬性僅適用於共用端。 |
VT_BOOL |
| “FrameCaptureIntervalInMs” |
指定畫面格擷取間隔。 根據預設，畫面擷取間隔為33毫秒，其對應於每秒30個畫面格。
您可以使用這個屬性來優化效能。 如果螢幕更新不需要經常完成，可以增加擷取間隔。 例如，值為 400 毫秒會導致每秒 2.5 個畫面格。 此屬性僅適用於共用端。 |
VT_I4 |
| “DefaultAttendeeControlLevel” |
指定出席者的預設控制層級。 根據預設，此值不會) CTRL_LEVEL_NONE (。 您可以將此值變更為CTRL_LEVEL_VIEW (检视) 。
預設控制層級無法設定為互動式。 此屬性僅適用於共用端。 |
VT_I4 |
| “EnableClipboardRedirect” |
如果此屬性的值為 VARIANT_TRUE，則會啟動共用與查看器之間的剪貼簿。 預設值為 VARIANT_FALSE。
若要使用剪貼簿共用，會話必須處於互動式模式。 只有單一聯機可以共用剪貼簿。 最近取得輸入控件的聯機會接管剪貼簿共用。 任何先前連線的剪貼簿共享都會自動停用。 此屬性只能用於傳統型應用程式。 此屬性僅適用於共用端。 此屬性從 1511 版 Windows 10 開始提供。 |
VT_BOOL |
| “SetClipboardRedirectCallback” |
指定 IRDPSRAPIClipboardUseEvents 實例的 IUnknown 指標，每次嘗試從共用電腦複製到查看器時收到回呼。 只有在啟用剪貼簿共用時，這個屬性才相關。
呼叫 IRDPSRAPISharingSession：：Open 方法之後，這個屬性會變成唯讀。 您只能在呼叫該方法之前設定這個屬性。 此屬性只能用於傳統型應用程式。 此屬性僅適用於共用端。 此屬性從 1511 版 Windows 10 開始提供。 |
VT_UNKNOWN |
| “EnabledTransports” |
指定要啟用的傳輸。 值為 3 同時支援 TCP 和 UDP。 默認值為 1，僅限 TCP。
呼叫 IRDPSRAPISharingSession：：Open 方法之後，這個屬性會變成唯讀。 您只能在呼叫該方法之前設定這個屬性。 此屬性從 1803 版 Windows 10 開始提供。 此屬性僅適用於共用端。 |
VT_I4 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | rdpencomapi.h |
| Dll | RdpEncom.dll |