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]。Type = 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]。Type = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[2].u.ulVal = 除零以外的任何值运行应用程序，零表示停止

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

由 WinLogon 用于确定登录屏幕的大小。

pPropertyEntriesIn 参数将为 NULL。

将 pPropertyEntriesOut 参数设置为以下内容：

pPropertyEntriesOut[0]。Type = 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]。Type = 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]。Type = 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)