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

Статья
08/28/2023

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

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

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

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.

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

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

Целое число, содержащее число 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)