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


Метод IWTSProtocolConnection::QueryProperty (wtsprotocol.h)

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

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

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

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

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

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

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

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

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

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

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

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

[in] ulNumEntriesIn

Целое число, содержащее число WTS_PROPERTY_VALUE структур, переданных в аргументе pPropertyEntriesIn .

[in] ulNumEntriesOut

Целое число, содержащее число WTS_PROPERTY_VALUE структур, переданных в аргументе pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

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

[out, optional] pPropertyEntriesOut

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

Возвращаемое значение

None

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 R2
Целевая платформа Windows
Header wtsprotocol.h (включая Wtsdefs.h)

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

IWRdsProtocolConnection

IWRdsProtocolConnection::QueryProperty

IWTSProtocolConnection

TSMF_SUPPORT_DATA_IN

TSMF_SUPPORT_DATA_OUT

WRDS_DYNAMIC_TIME_ZONE_INFORMATION

WTS_PROPERTY_VALUE