通过

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 是否会在会话创建期间启动任何自定义 Shell 之前启动。 ShellAppRuntime.exe 实现对自定义 Shell 的通用应用支持。 默认情况下不启用此功能， (等效于传递零) 。 这在 Server 2019 及更高版本或Windows 10多会话版本 18950 及更高版本的 Windows 版本中可用。

pPropertyEntriesIn 参数将为 NULL。

输出时，在 pPropertyEntriesOut 参数中传递以下WRDS_PROPERTY_VALUE结构：

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 表示不启用对自定义 Shell 的通用应用支持，1 启用自定义 Shell 的通用应用支持

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