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

Recupera um valor de propriedade do protocolo. Esse método pode ser usado por outros módulos do Windows para solicitar dados ou enviar dados para o protocolo.

Sintaxe

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

Um GUID que especifica a propriedade solicitada. Esse pode ser um dos valores a seguir.

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

Enviado pelo serviço de Serviços de Área de Trabalho Remota para determinar se um aplicativo inicial deve ter permissão para ser executado.

Na entrada, o serviço de Serviços de Área de Trabalho Remota passa três estruturas de WRDS_PROPERTY_VALUE no parâmetro pPropertyEntriesIn :

Estrutura de entrada 1:

• pPropertyEntriesIn[0].Type = WRDS_VALUE_TYPE_STRING
• pPropertyEntriesIn[0].u.strVal.pstrVal = nome do aplicativo
• pPropertyEntriesIn[0].u.strVal.size = comprimento da cadeia de caracteres de nome

• pPropertyEntriesIn[1].Type = WRDS_VALUE_TYPE_STRING
• pPropertyEntriesIn[1].u.strVal.pstrVal = parâmetros do aplicativo
• pPropertyEntriesIn[1].u.strVal.size = comprimento da cadeia de caracteres de parâmetro

• pPropertyEntriesIn[2].Type = WRDS_VALUE_TYPE_ULONG
• pPropertyEntriesIn[2].u.ulVal = Reservados

Estrutura de saída 1:

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
• pPropertyEntriesOut[0].u.strVal.pstrVal = linha de comando, incluindo o diretório
• pPropertyEntriesOut[0].u.strVal.size = comprimento da linha de comando

• pPropertyEntriesOut[1].Type = WRDS_VALUE_TYPE_STRING
• pPropertyEntriesOut[1].u.strVal.pstrVal = parâmetros do aplicativo
• pPropertyEntriesOut[1].u.strVal.size = comprimento da cadeia de caracteres de parâmetro

• pPropertyEntriesOut[2].Type = WRDS_VALUE_TYPE_ULONG
• pPropertyEntriesOut[2].u.ulVal = Qualquer valor diferente de zero para executar o aplicativo, zero para parar

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

Usado pelo WinLogon para determinar o tamanho da tela de logon.

O parâmetro pPropertyEntriesIn será NULL.

Defina o parâmetro pPropertyEntriesOut para o seguinte:

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
• pPropertyEntriesOut[0].u.ulVal = tamanho da tela

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

Usado pelo serviço de Serviços de Área de Trabalho Remota para consultar o nome da DLL do enumerador de áudio remoto.

O parâmetro pPropertyEntriesIn será NULL.

Defina o parâmetro pPropertyEntriesOut para o seguinte:

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
• pPropertyEntriesOut[0].u.strVal.pstrVal = Nome da DLL

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

Usado pelo plug-in Remote Desktop Media Foundation para determinar os objetos de coletor a serem usados para formatos de mídia específicos.

Na entrada, o RCM passa a seguinte estrutura WRDS_PROPERTY_VALUE no parâmetro pPropertyEntriesIn :

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_BINARY
• pPropertyEntriesOut[0].u.bVal.pbVal = estrutura TSMF_SUPPORT_DATA_IN
• pPropertyEntriesOut[0].u.bVal.size = tamanho da estrutura TSMF_SUPPORT_DATA_IN

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_BINARY
• pPropertyEntriesOut[0].u.bVal.pbVal = estrutura TSMF_SUPPORT_DATA_OUT
• pPropertyEntriesOut[0].u.bVal.size = Tamanho da estrutura de TSMF_SUPPORT_DATA_OUT

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

Usado para recuperar as informações de fuso horário dinâmico de uma conexão.

O parâmetro pPropertyEntriesIn será NULL.

Na saída, passe a seguinte estrutura WRDS_PROPERTY_VALUE no parâmetro pPropertyEntriesOut :

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_BINARY
• pPropertyEntriesOut[0].u.bVal.pbVal = estrutura WRDS_DYNAMIC_TIME_ZONE_INFORMATION
• pPropertyEntriesOut[0].u.bVal.size = Tamanho da estrutura de WRDS_DYNAMIC_TIME_ZONE_INFORMATION

CONNECTION_PROPERTY_CURSOR_BLINK_DISABLED (4b150580-fea4-4d3c-9de4-7433a66618f7)

Usado para determinar se o cursor pisca deve ser desabilitado.

O parâmetro pPropertyEntriesIn será NULL.

Na saída, passe a seguinte estrutura WRDS_PROPERTY_VALUE no parâmetro pPropertyEntriesOut :

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
• pPropertyEntriesOut[0].u.ulVal = 1 para desabilitar o piscar do cursor, caso contrário, 0

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

Usado pelo serviço de Serviços de Área de Trabalho Remota para determinar o modo de reconexão a ser usado.

O parâmetro pPropertyEntriesIn será NULL.

Na saída, passe a seguinte estrutura WRDS_PROPERTY_VALUE no parâmetro pPropertyEntriesOut :

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
• pPropertyEntriesOut[0].u.ulVal = 0 para desabilitar a reconexão rápida, 1 para Reconexão Rápida Básica, 2 para Reconexão Rápida Aprimorada

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

Usado pelo serviço de Serviços de Área de Trabalho Remota durante a Reconexão Rápida Aprimorada para recuperar o SID do Usuário pelo qual as sessões a serem reconectadas são filtradas.

O parâmetro pPropertyEntriesIn será NULL.

Na saída, passe a seguinte estrutura WRDS_PROPERTY_VALUE no parâmetro pPropertyEntriesOut :

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
• pPropertyEntriesIn[0].u.strVal.pstrVal = SID do usuário a ser usado como filtro de sessão
• pPropertyEntriesIn[0].u.strVal.size = Comprimento do SID do Usuário, incluindo o caractere de terminação nula

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

Usado pelo serviço de Serviços de Área de Trabalho Remota, determine se ShellAppRuntime.exe será iniciado antes de quaisquer Shells Personalizados durante a criação da sessão. ShellAppRuntime.exe implementa o suporte ao Aplicativo Universal para Shells Personalizados. Isso não está habilitado por padrão (equivalente a passar zero). Isso está disponível em versões do Windows que são o Server 2019 e superior ou Windows 10 Build de várias sessões 18950 e superior.

O parâmetro pPropertyEntriesIn será NULL.

Na saída, passe a seguinte estrutura WRDS_PROPERTY_VALUE no parâmetro pPropertyEntriesOut :

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
• pPropertyEntriesOut[0].u.ulVal = 0 para não habilitar o Suporte a Aplicativos Universais para Shells Personalizados, 1 Habilitar o Suporte a Aplicativos Universais para Shells Personalizados

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

Usado para determinar se um prompt de aviso de logoff é exibido quando o temporizador ocioso expira.

O parâmetro pPropertyEntriesIn será NULL.

Na saída, passe a seguinte estrutura WRDS_PROPERTY_VALUE no parâmetro pPropertyEntriesOut :

• pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
• pPropertyEntriesOut[0].u.ulVal = 0 para desabilitar o prompt de aviso, 1 para habilitá-lo

[in] ulNumEntriesIn

O número de entradas na matriz pPropertyEntriesIn .

[in] ulNumEntriesOut

O número de entradas na matriz pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

Uma matriz de ponteiros para WRDS_PROPERTY_VALUE estruturas que podem ser usadas para ajudar a localizar as informações de propriedade solicitadas.

[out, optional] pPropertyEntriesOut

Uma matriz de ponteiros para WRDS_PROPERTY_VALUE estruturas que recebem os valores de propriedade solicitados.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Confira também

IWRdsProtocolConnection