Método IWTSProtocolConnection::QueryProperty (wtsprotocol.h)

Artículo
08/28/2023

[IWTSProtocolConnection::QueryProperty ya no está disponible para su uso a partir de Windows Server 2012. En su lugar, use IWRdsProtocolConnection::QueryProperty.]

Recupera la propiedad especificada del protocolo. Otros módulos de Windows pueden usar este método para solicitar o enviar datos al protocolo.

Sintaxis

HRESULT QueryProperty(
  [in]            GUID                QueryType,
  [in]            ULONG               ulNumEntriesIn,
  [in]            ULONG               ulNumEntriesOut,
  [in, optional]  PWTS_PROPERTY_VALUE pPropertyEntriesIn,
  [out, optional] PWTS_PROPERTY_VALUE pPropertyEntriesOut
);

Parámetros

[in] QueryType

GUID que especifica la propiedad . Puede ser uno de los siguientes valores.

WTS_QUERY_ALLOWED_INITIAL_APP (C77D1B30-5BE1-4c6b-A0E1-BD6D2E5C9FCC)

Enviado por el servicio Servicios de Escritorio remoto para determinar si se debe permitir la ejecución de una aplicación inicial.

En la entrada, el servicio Servicios de Escritorio remoto pasa tres estructuras de WTS_PROPERTY_VALUE en el parámetro pPropertyEntriesIn :

Estructura de entrada 1:

pPropertyEntriesIn[0]. Tipo = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[0].u.strVal.pstrVal = nombre de aplicación
pPropertyEntriesIn[0].u.strVal.size = longitud de la cadena de nombre

Estructura de entrada 2:

pPropertyEntriesIn[1]. Tipo = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[1].u.strVal.pstrVal = parámetros de aplicación
pPropertyEntriesIn[1].u.strVal.size = longitud de la cadena de parámetro

Estructura de entrada 3:

pPropertyEntriesIn[2]. Tipo = WTS_VALUE_TYPE_ULONG
pPropertyEntriesIn[2].u.ulVal = reserved

En la salida, pase las siguientes tres estructuras WTS_PROPERTY_VALUE en el parámetro pPropertyEntriesOut . Si desea usar la aplicación pasada por el servicio Servicios de Escritorio remoto, copie las estructuras de entrada 1 y 2 en las estructuras de salida 1 y 2.

Estructura de salida 1:

pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = línea de comandos, incluido el directorio
pPropertyEntriesOut[0].u.strVal.size = longitud de la línea de comandos

Estructura de salida 2:

pPropertyEntriesOut[1]. Tipo = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[1].u.strVal.pstrVal = parámetros de aplicación
pPropertyEntriesOut[1].u.strVal.size = longitud de la cadena de parámetro

Estructura de salida 3:

pPropertyEntriesOut[2]. Tipo = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[2].u.ulVal = Cualquier valor distinto de cero para ejecutar la aplicación, cero para detener

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

Lo usa WinLogon para determinar el tamaño de la pantalla de inicio de sesión.

El parámetro pPropertyEntriesIn será NULL.

Establezca el parámetro pPropertyEntriesOut en lo siguiente:

pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[0].u.ulVal = tamaño de pantalla

Si no desea usar el tamaño de pantalla predeterminado, el protocolo debe devolver E_NOTIMPL.

WTS_QUERY_AUDIOENUM_DLL (9bf4fa97-c883-4c2a-80ab-5a39c9af00db)

Usado por el servicio Servicios de Escritorio remoto para consultar el nombre del archivo DLL del enumerador de audio remoto.

El parámetro pPropertyEntriesIn será NULL.

Establezca el parámetro pPropertyEntriesOut en el siguiente :

pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = nombre de DLL

Debe asignar la memoria para pstrVal mediante la función LocalAlloc .

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

Usado por el complemento Media Foundation de Escritorio remoto para determinar los objetos receptores que se usarán para formatos multimedia específicos.

En la entrada, el RCM pasa la siguiente estructura de WTS_PROPERTY_VALUE en el parámetro pPropertyEntriesIn :

pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_IN
pPropertyEntriesOut[0].u.bVal.size = Tamaño de TSMF_SUPPORT_DATA_IN

En la salida, pase la siguiente estructura de WTS_PROPERTY_VALUE en el parámetro pPropertyEntriesOut .

pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_OUT
pPropertyEntriesOut[0].u.bVal.size = Tamaño de TSMF_SUPPORT_DATA_OUT

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

Se usa para recuperar la información de zona horaria dinámica de una conexión.

El parámetro pPropertyEntriesIn será NULL.

En la salida, pase la siguiente estructura de WRDS_PROPERTY_VALUE en el parámetro pPropertyEntriesOut :

pPropertyEntriesOut[0]. Tipo = WRDS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = estructura de WRDS_DYNAMIC_TIME_ZONE_INFORMATION
pPropertyEntriesOut[0].u.bVal.size = Tamaño de WRDS_DYNAMIC_TIME_ZONE_INFORMATION estructura

[in] ulNumEntriesIn

Entero que contiene el número de estructuras de WTS_PROPERTY_VALUE pasadas en el argumento pPropertyEntriesIn .

[in] ulNumEntriesOut

Entero que contiene el número de estructuras de WTS_PROPERTY_VALUE pasadas en el argumento pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

Una o varias estructuras de WTS_PROPERTY_VALUE que se pueden usar para ayudar a encontrar la información de propiedad solicitada.

[out, optional] pPropertyEntriesOut

Una o varias estructuras WTS_PROPERTY_VALUE que contienen la información de propiedad solicitada.

Valor devuelto

None

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Windows
Encabezado	wtsprotocol.h (incluya Wtsdefs.h)