IRDPSRAPISessionProperties：：get_Property 方法 (rdpencomapi.h)
設定或取得具名會話屬性。
這是可讀寫的屬性。
語法
HRESULT get_Property(
BSTR PropertyName,
VARIANT *pVal
);
參數
PropertyName
pVal
傳回值
無
備註
您可以設定並取得下列屬性。 屬性名稱會區分大小寫。
| 屬性名稱 | 屬性描述 | 值類型 |
|---|---|---|
| “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。
若要使用剪貼簿共用，會話必須處於互動式模式。 只有單一聯機可以共用剪貼簿。 最近取得輸入控件的連接會接管剪貼簿共用。 系統會自動停用任何先前連線的剪貼簿共用。 此屬性只能用於傳統型應用程式。 此屬性僅適用於共用端。 從 Windows 10 1511 版開始，即可使用此屬性。 |
VT_BOOL |
| “SetClipboardRedirectCallback” |
指定 IRDPSRAPIClipboardUseEvents 實例的 IUnknown 指標，每次嘗試從共用電腦複製到查看器時收到回呼。 只有在啟用剪貼簿共享時，此屬性才相關。
呼叫 IRDPSRAPISharingSession：：Open 方法之後，這個屬性會變成唯讀。 您只能在呼叫該方法之前設定此屬性。 此屬性只能用於傳統型應用程式。 此屬性僅適用於共用端。 從 Windows 10 1511 版開始，即可使用此屬性。 |
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 |