Método IWRdsProtocolConnection::QueryProperty (wtsprotocol.h)
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_STRINGpPropertyEntriesIn[0].u.strVal.pstrVal =
nombre de la aplicaciónpPropertyEntriesIn[0].u.strVal.size =
longitud de la cadena de nombre
pPropertyEntriesIn[1].Type =
WRDS_VALUE_TYPE_STRINGpPropertyEntriesIn[1].u.strVal.pstrVal =
parámetros de aplicaciónpPropertyEntriesIn[1].u.strVal.size =
longitud de la cadena de parámetro
pPropertyEntriesIn[2].Type =
WRDS_VALUE_TYPE_ULONGpPropertyEntriesIn[2].u.ulVal =
Reservados
Estructura de salida 1:
pPropertyEntriesOut[0].Type =
WRDS_VALUE_TYPE_STRINGpPropertyEntriesOut[0].u.strVal.pstrVal =
línea de comandos, incluido el directoriopPropertyEntriesOut[0].u.strVal.size =
longitud de la línea de comandos
pPropertyEntriesOut[1].Type =
WRDS_VALUE_TYPE_STRINGpPropertyEntriesOut[1].u.strVal.pstrVal =
parámetros de aplicaciónpPropertyEntriesOut[1].u.strVal.size =
longitud de la cadena de parámetro
pPropertyEntriesOut[2].Type =
WRDS_VALUE_TYPE_ULONGpPropertyEntriesOut[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_ULONGpPropertyEntriesOut[0].u.ulVal =
tamaño de pantalla
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_STRINGpPropertyEntriesOut[0].u.strVal.pstrVal =
Nombre del archivo DLL
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 :
pPropertyEntriesOut[0].Type =
WRDS_VALUE_TYPE_BINARYpPropertyEntriesOut[0].u.bVal.pbVal =
estructura de TSMF_SUPPORT_DATA_INpPropertyEntriesOut[0].u.bVal.size =
tamaño de la estructura de TSMF_SUPPORT_DATA_IN
pPropertyEntriesOut[0].Type =
WRDS_VALUE_TYPE_BINARYpPropertyEntriesOut[0].u.bVal.pbVal =
estructura de TSMF_SUPPORT_DATA_OUTpPropertyEntriesOut[0].u.bVal.size =
Tamaño de la estructura 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 WRDS_PROPERTY_VALUE en el parámetro pPropertyEntriesOut :
pPropertyEntriesOut[0].Type =
WRDS_VALUE_TYPE_BINARYpPropertyEntriesOut[0].u.bVal.pbVal =
estructura de WRDS_DYNAMIC_TIME_ZONE_INFORMATIONpPropertyEntriesOut[0].u.bVal.size =
Tamaño de la estructura de WRDS_DYNAMIC_TIME_ZONE_INFORMATION
CONNECTION_PROPERTY_CURSOR_BLINK_DISABLED (4b150580-fea4-4d3c-9de4-7433a66618f7)
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_ULONGpPropertyEntriesOut[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_ULONGpPropertyEntriesOut[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_STRINGpPropertyEntriesIn[0].u.strVal.pstrVal =
SID de usuario que se va a usar como filtro de sesiónpPropertyEntriesIn[0].u.strVal.size =
Longitud del SID de usuario, incluido el carácter de terminación null
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_ULONGpPropertyEntriesOut[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_ULONGpPropertyEntriesOut[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) |