IWTSProtocolConnection：：QueryProperty 方法 (wtsprotocol.h)

發行項
03/04/2024

[IWTSProtocolConnection：：QueryProperty 已不再可供 Windows Server 2012 使用。請改用 IWRdsProtocolConnection：：QueryProperty.]

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

語法

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

參數

[in] QueryType

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

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

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

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

輸入結構 1：

pPropertyEntriesIn[0]。Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[0].u.strVal.pstrVal = 應用程式名稱
pPropertyEntriesIn[0].u.strVal.size = 名稱字串的長度

輸入結構 2：

pPropertyEntriesIn[1]。Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[1].u.strVal.pstrVal = 應用程式參數
pPropertyEntriesIn[1].u.strVal.size = 參數位符串的長度

輸入結構 3：

pPropertyEntriesIn[2]。類型 = WTS_VALUE_TYPE_ULONG
pPropertyEntriesIn[2].u.ulVal = reserved

在輸出上，在 pPropertyEntriesOut 參數中傳遞下列三個WTS_PROPERTY_VALUE結構。如果您想要使用遠端桌面服務傳入的應用程式，請將輸入結構 1 和 2 複製到輸出結構 1 和 2。

輸出結構 1：

pPropertyEntriesOut[0]。Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = 命令行，包括目錄
pPropertyEntriesOut[0].u.strVal.size = 命令行的長度

輸出結構 2：

pPropertyEntriesOut[1]。Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[1].u.strVal.pstrVal = 應用程式參數
pPropertyEntriesOut[1].u.strVal.size = 參數位符串的長度

輸出結構 3：

pPropertyEntriesOut[2]。類型 = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[2].u.ulVal = 執行應用程式以外的任何值，零停止

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

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

pPropertyEntriesIn 參數會是 NULL。

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

pPropertyEntriesOut[0]。類型 = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[0].u.ulVal = 螢幕大小

如果您不想使用默認螢幕大小，通訊協議必須 傳回E_NOTIMPL。

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

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

pPropertyEntriesIn 參數會是 NULL。

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

pPropertyEntriesOut[0]。Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = DLL 名稱

您必須使用 LocalAlloc 函式來配置 pstrVal 的記憶體。

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

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

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

pPropertyEntriesOut[0]。類型 = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_IN
pPropertyEntriesOut[0].u.bVal.size = 大小TSMF_SUPPORT_DATA_IN

在輸出上，在 pPropertyEntriesOut 參數中傳遞下列WTS_PROPERTY_VALUE結構。

pPropertyEntriesOut[0]。類型 = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_OUT
pPropertyEntriesOut[0].u.bVal.size = 大小TSMF_SUPPORT_DATA_OUT

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

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

pPropertyEntriesIn 參數會是 NULL。

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

pPropertyEntriesOut[0]。Type = WRDS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = WRDS_DYNAMIC_TIME_ZONE_INFORMATION 結構
pPropertyEntriesOut[0].u.bVal.size = WRDS_DYNAMIC_TIME_ZONE_INFORMATION 結構的大小

[in] ulNumEntriesIn

整數，包含 pPropertyEntriesIn 自變數中傳遞的WTS_PROPERTY_VALUE結構數目。

[in] ulNumEntriesOut

整數，包含 pPropertyEntriesOut 自變數中傳遞的WTS_PROPERTY_VALUE結構數目。

[in, optional] pPropertyEntriesIn

一或多個 WTS_PROPERTY_VALUE 結構，可用來協助尋找要求的屬性資訊。

[out, optional] pPropertyEntriesOut

包含所要求屬性資訊的一或多個 WTS_PROPERTY_VALUE 結構。

傳回值

無

規格需求

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