Compartir a través de

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

  • Artículo

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

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

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 :

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

Consulte también

IWRdsProtocolConnection

IWRdsProtocolConnection::QueryProperty

IWTSProtocolConnection

TSMF_SUPPORT_DATA_IN

TSMF_SUPPORT_DATA_OUT

WRDS_DYNAMIC_TIME_ZONE_INFORMATION

WTS_PROPERTY_VALUE