Compartir a través de

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

  • Artículo

Recupera un valor de propiedad 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]  PWRDS_PROPERTY_VALUE pPropertyEntriesIn,
  [out, optional] PWRDS_PROPERTY_VALUE pPropertyEntriesOut
);

Parámetros

[in] QueryType

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

WRDS_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 WRDS_PROPERTY_VALUE en el parámetro pPropertyEntriesIn :

Estructura de entrada 1:

  • pPropertyEntriesIn[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = nombre de la aplicación
  • pPropertyEntriesIn[0].u.strVal.size = longitud de la cadena de nombre
Estructura de entrada 2:
  • pPropertyEntriesIn[1].Type = WRDS_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].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = Reservados
En la salida, pase las tres estructuras WRDS_PROPERTY_VALUE siguientes 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].Type = WRDS_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].Type = WRDS_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].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = Cualquier valor distinto de cero para ejecutar la aplicación, cero para detener

WRDS_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].Type = WRDS_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.

WRDS_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 lo siguiente:

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = Nombre del archivo DLL
Debe asignar la memoria para pstrVal mediante la función LocalAlloc .

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

Usado por el complemento de 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 WRDS_PROPERTY_VALUE en el parámetro pPropertyEntriesIn :

En la salida, pase la siguiente estructura WRDS_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 WRDS_PROPERTY_VALUE en el parámetro pPropertyEntriesOut :

Se usa para determinar si se debe deshabilitar el parpadeo del cursor.

El parámetro pPropertyEntriesIn será NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 1 para deshabilitar el parpadeo del cursor; de lo contrario, 0

PROPERTY_TYPE_GET_FAST_RECONNECT (6212d757-0043-4862-99c3-9f3059ac2a3b)

Usado por el servicio Servicios de Escritorio remoto para determinar el modo de reconexión que se va a usar.

El parámetro pPropertyEntriesIn será NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 para deshabilitar la reconexión rápida, 1 para la reconexión rápida básica, 2 para la reconexión rápida mejorada

PROPERTY_TYPE_GET_FAST_RECONNECT_USER_SID (197c427a-0135-4b6d-9c5e-e6579a0ab625)

Usado por el servicio Servicios de Escritorio remoto durante la reconexión rápida mejorada para recuperar el SID de usuario mediante el cual se filtran las sesiones a las que se va a volver a conectar.

El parámetro pPropertyEntriesIn será NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = SID de usuario que se va a usar como filtro de sesión
  • pPropertyEntriesIn[0].u.strVal.size = Longitud del SID de usuario, incluido el carácter de terminación null
Debe asignar la memoria para pstrVal mediante la función LocalAlloc .

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

El servicio Servicios de Escritorio remoto usa para determinar si ShellAppRuntime.exe se iniciará antes de que se inicien shells personalizados durante la creación de la sesión. ShellAppRuntime.exe implementa la compatibilidad de aplicaciones universales con shells personalizados. Esto no está habilitado de forma predeterminada (equivalente a pasar cero). Esto está disponible en versiones de Windows que son Server 2019 y versiones posteriores o Windows 10 compilación 18950 y posteriores.

El parámetro pPropertyEntriesIn será NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 para no habilitar la compatibilidad de aplicaciones universales con shells personalizados, 1 Habilitar la compatibilidad con aplicaciones universales para shells personalizados

CONNECTION_PROPERTY_IDLE_TIME_WARNING (693f7ff5-0c4e-4d17-b8e0-1f70325e5d58)

Se usa para determinar si se muestra un mensaje de advertencia de cierre de sesión cuando expira el temporizador de inactividad.

El parámetro pPropertyEntriesIn será NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 para deshabilitar el aviso de advertencia, 1 para habilitarlo

[in] ulNumEntriesIn

Número de entradas de la matriz pPropertyEntriesIn .

[in] ulNumEntriesOut

Número de entradas de la matriz pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

Matriz de punteros a WRDS_PROPERTY_VALUE estructuras que se pueden usar para ayudar a encontrar la información de propiedad solicitada.

[out, optional] pPropertyEntriesOut

Matriz de punteros a WRDS_PROPERTY_VALUE estructuras que reciben los valores de propiedad solicitados.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

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

Consulte también

IWRdsProtocolConnection