共用方式為

IWRdsProtocolConnection：：QueryProperty 方法 (wtsprotocol.h)

  • 發行項

從通訊協定擷取屬性值。 其他 Windows 模組可以使用此方法來要求數據，或將數據傳送至通訊協定。

語法

HRESULT QueryProperty(
  [in]            GUID                 QueryType,
  [in]            ULONG                ulNumEntriesIn,
  [in]            ULONG                ulNumEntriesOut,
  [in, optional]  PWRDS_PROPERTY_VALUE pPropertyEntriesIn,
  [out, optional] PWRDS_PROPERTY_VALUE pPropertyEntriesOut
);

參數

[in] QueryType

指定所要求屬性的 GUID 。 這可以是下列其中一個值。

WRDS_QUERY_ALLOWED_INITIAL_APP (C77D1B30-5BE1-4c6b-A0E1-BD6D2E5C9FCC)

由遠端桌面服務服務傳送，以判斷是否應該允許執行初始應用程式。

在輸入時，遠端桌面服務服務會在 pPropertyEntriesIn 參數中傳遞三個WRDS_PROPERTY_VALUE結構：

輸入結構 1：

  • pPropertyEntriesIn[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = 應用程式名稱
  • pPropertyEntriesIn[0].u.strVal.size = 名稱字串的長度
輸入結構 2：
  • pPropertyEntriesIn[1].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[1].u.strVal.pstrVal = 應用程式參數
  • pPropertyEntriesIn[1].u.strVal.size = 參數位串的長度
輸入結構 3：
  • pPropertyEntriesIn[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = 保留
在輸出上，在 pPropertyEntriesOut 參數中傳遞下列三個WRDS_PROPERTY_VALUE結構。 如果您想要使用遠端桌面服務傳入的應用程式，請將輸入結構 1 和 2 複製到輸出結構 1 和 2。

輸出結構 1：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = 包含目錄的命令列
  • pPropertyEntriesOut[0].u.strVal.size = 命令行的長度
輸出結構 2：
  • pPropertyEntriesOut[1].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[1].u.strVal.pstrVal = 應用程式參數
  • pPropertyEntriesOut[1].u.strVal.size = 參數位串的長度
輸出結構 3：
  • pPropertyEntriesOut[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = 執行應用程式以外的任何值，零要停止

WRDS_QUERY_LOGON_SCREEN_SIZE (8b8e0fe7-0804-4a0e-b279-8660b1df0049)

由 WinLogon 用來判斷登入畫面的大小。

pPropertyEntriesIn 參數會是 NULL。

將 pPropertyEntriesOut 參數設定為下列專案：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 螢幕大小
如果您不想使用默認螢幕大小，通訊協議必須 傳回E_NOTIMPL。

WRDS_QUERY_AUDIOENUM_DLL (9bf4fa97-c883-4c2a-80ab-5a39c9af00db)

由遠端桌面服務服務用來查詢遠端音訊列舉值 DLL 的名稱。

pPropertyEntriesIn 參數會是 NULL。

將 pPropertyEntriesOut 參數設定為下列專案：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = DLL 名稱
您必須使用 LocalAlloc 函式來配置 pstrVal 的記憶體。

WRDS_QUERY_MF_FORMAT_SUPPORT (41869ad0-6332-4dc8-95d5-db749e2f1d94)

由遠端桌面媒體基礎外掛程式用來判斷要用於特定媒體格式的接收物件。

在輸入時，RCM 會在 pPropertyEntriesIn 參數中傳遞下列WRDS_PROPERTY_VALUE結構：

在輸出中，在 pPropertyEntriesOut 參數中傳遞下列WRDS_PROPERTY_VALUE結構：

PROPERTY_DYNAMIC_TIME_ZONE_INFORMATION (cdfd28e-d0b9-4c1f-a5eb-6d1f6c6535b9)

用來從連接擷取動態時區資訊。

pPropertyEntriesIn 參數會是 NULL。

在輸出中，在 pPropertyEntriesOut 參數中傳遞下列WRDS_PROPERTY_VALUE結構：

用來判斷是否應該停用游標閃爍。

pPropertyEntriesIn 參數會是 NULL。

在輸出中，在 pPropertyEntriesOut 參數中傳遞下列WRDS_PROPERTY_VALUE結構：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 1 表示停用游標閃爍，否則為 0

PROPERTY_TYPE_GET_FAST_RECONNECT (6212d757-0043-4862-99c3-9f3059ac2a3b)

由遠端桌面服務服務用來判斷要使用的重新連線模式。

pPropertyEntriesIn 參數會是 NULL。

在輸出中，在 pPropertyEntriesOut 參數中傳遞下列WRDS_PROPERTY_VALUE結構：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 停用快速重新連線，1 用於基本快速重新連線，2 用於增強快速重新連線

PROPERTY_TYPE_GET_FAST_RECONNECT_USER_SID (197c427a-0135-4b6d-9c5e-e6579a0ab625)

在增強型快速重新連線期間由遠端桌面服務服務使用，以擷取要重新連線的會話經過篩選的使用者 SID。

pPropertyEntriesIn 參數會是 NULL。

在輸出中，在 pPropertyEntriesOut 參數中傳遞下列WRDS_PROPERTY_VALUE結構：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = 要當做會話篩選使用的使用者 SID
  • pPropertyEntriesIn[0].u.strVal.size = 使用者 SID 的長度，包括 Null 終止字元
您必須使用 LocalAlloc 函式來配置 pstrVal 的記憶體。

PROPERTY_TYPE_ENABLE_UNIVERSAL_APPS_FOR_CUSTOM_SHELL (ed2c3fda-338d-4d3f-81a3-e767310d908e)

遠端桌面服務服務會使用 ，判斷在會話建立期間，是否將在任何自定義殼層之前啟動 ShellAppRuntime.exe。 ShellAppRuntime.exe 實作自定義殼層的通用應用程式支援。 默認不會啟用此功能， (相當於傳遞零) 。 這適用於 Server 2019 和更新版本或 Windows 10 多會話組建 18950 和更新版本的 Windows 版本。

pPropertyEntriesIn 參數會是 NULL。

在輸出中，在 pPropertyEntriesOut 參數中傳遞下列WRDS_PROPERTY_VALUE結構：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 表示未啟用自定義殼層的通用應用程式支援，1 啟用自定義殼層的通用應用程式支援

CONNECTION_PROPERTY_IDLE_TIME_WARNING (693f7ff5-0c4e-4d17-b8e0-1f70325e5d58)

用來判斷閑置定時器到期時是否顯示註銷警告提示。

pPropertyEntriesIn 參數會是 NULL。

在輸出中，在 pPropertyEntriesOut 參數中傳遞下列WRDS_PROPERTY_VALUE結構：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 停用警告提示，1 啟用它

[in] ulNumEntriesIn

pPropertyEntriesIn 陣列中的項目數。

[in] ulNumEntriesOut

pPropertyEntriesOut 陣列中的項目數。

[in, optional] pPropertyEntriesIn

可用來協助尋找所要求屬性資訊的 WRDS_PROPERTY_VALUE 結構的指標陣列。

[out, optional] pPropertyEntriesOut

接收所要求屬性值 之結構WRDS_PROPERTY_VALUE 指標數位。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2012
目標平台 Windows
標頭 wtsprotocol.h (包含 Wtsdefs.h)

另請參閱

IWRdsProtocolConnection