Compartilhar via

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

  • Artigo

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
Estrutura de entrada 2:
  • 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
Estrutura de entrada 3:
  • pPropertyEntriesIn[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = Reservados
Na saída, passe as três estruturas de WRDS_PROPERTY_VALUE a seguir no parâmetro pPropertyEntriesOut . Se você quiser usar o aplicativo passado pelo serviço de Serviços de Área de Trabalho Remota, copie as estruturas de entrada 1 e 2 para as estruturas de saída 1 e 2.

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
Estrutura de saída 2:
  • 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
Estrutura de saída 3:
  • 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
Se você não quiser usar o tamanho da tela padrão, o protocolo deverá retornar E_NOTIMPL.

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
Você deve alocar a memória para pstrVal usando a função LocalAlloc .

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 :

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

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 :

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
Você deve alocar a memória para pstrVal usando a função LocalAlloc .

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

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho wtsprotocol.h (include Wtsdefs.h)

Confira também

IWRdsProtocolConnection