Поделиться через

Метод 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)

Отправляется службой удаленных рабочих столов, чтобы определить, должно ли быть разрешено запускать исходное приложение.

При входе служба удаленных рабочих столов передает три структуры WRDS_PROPERTY_VALUE в параметре pPropertyEntriesIn :

Структура входных данных 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 = Защищены
В выходных данных передайте следующие три структуры WRDS_PROPERTY_VALUE в параметре pPropertyEntriesOut . Если вы хотите использовать приложение, переданное службой удаленных рабочих столов, скопируйте входные структуры 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
Необходимо выделить память для pstrVal с помощью функции LocalAlloc .

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

Используется подключаемым модулем Media Foundation для удаленного рабочего стола для определения объектов-приемников, которые будут использоваться для определенных форматов мультимедиа.

При входе RCM передает следующую структуру WRDS_PROPERTY_VALUE в параметре pPropertyEntriesIn :

В выходных данных передайте следующую структуру WRDS_PROPERTY_VALUE в параметре pPropertyEntriesOut :

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

Используется для получения динамических сведений о часовом поясе из подключения.

Параметр pPropertyEntriesIn будет иметь значение NULL.

В выходных данных передайте следующую структуру WRDS_PROPERTY_VALUE в параметре pPropertyEntriesOut :

Используется для определения того, следует ли отключать мигание курсора.

Параметр pPropertyEntriesIn будет иметь значение NULL.

В выходных данных передайте следующую структуру WRDS_PROPERTY_VALUE в параметре pPropertyEntriesOut :

  • 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.

В выходных данных передайте следующую структуру WRDS_PROPERTY_VALUE в параметре pPropertyEntriesOut :

  • 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)

Используется службой удаленных рабочих столов во время расширенного быстрого повторного подключения для получения идентификатора безопасности пользователя, по которому фильтруются сеансы для повторного подключения.

Параметр pPropertyEntriesIn будет иметь значение NULL.

В выходных данных передайте следующую структуру WRDS_PROPERTY_VALUE в параметре pPropertyEntriesOut :

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = Идентификатор безопасности пользователя, используемый в качестве фильтра сеанса
  • pPropertyEntriesIn[0].u.strVal.size = Длина идентификатора безопасности пользователя, включая символ конца null
Необходимо выделить память для pstrVal с помощью функции LocalAlloc .

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

Служба удаленных рабочих столов определяет, будет ли запускаться ShellAppRuntime.exe перед пользовательскими оболочками во время создания сеанса. ShellAppRuntime.exe реализует поддержку универсальных приложений для пользовательских оболочек. Это не включено по умолчанию (эквивалентно передаче нуля). Это доступно в версиях Windows Server 2019 и более поздних или Windows 10 многосеансовой сборки 18950 и более поздних версий.

Параметр pPropertyEntriesIn будет иметь значение NULL.

В выходных данных передайте следующую структуру WRDS_PROPERTY_VALUE в параметре pPropertyEntriesOut :

  • 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.

В выходных данных передайте следующую структуру WRDS_PROPERTY_VALUE в параметре pPropertyEntriesOut :

  • 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
Header wtsprotocol.h (включая Wtsdefs.h)

См. также раздел

IWRdsProtocolConnection