Compartilhar via

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

  • Artigo

[IWTSProtocolConnection::QueryProperty não está mais disponível para uso a partir de Windows Server 2012. Em vez disso, use IWRdsProtocolConnection::QueryProperty.]

Recupera a propriedade especificada 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]  PWTS_PROPERTY_VALUE pPropertyEntriesIn,
  [out, optional] PWTS_PROPERTY_VALUE pPropertyEntriesOut
);

Parâmetros

[in] QueryType

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

WTS_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 WTS_PROPERTY_VALUE no parâmetro pPropertyEntriesIn :

Estrutura de entrada 1:

  • pPropertyEntriesIn[0]. Tipo = WTS_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]. Tipo = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[1].u.strVal.pstrVal = parâmetros de aplicativo
  • pPropertyEntriesIn[1].u.strVal.size = comprimento da cadeia de caracteres de parâmetro
Estrutura de entrada 3:
  • pPropertyEntriesIn[2]. Tipo = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = reserved
Na saída, passe as três estruturas de WTS_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]. Tipo = WTS_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]. Tipo = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[1].u.strVal.pstrVal = parâmetros de aplicativo
  • pPropertyEntriesOut[1].u.strVal.size = comprimento da cadeia de caracteres de parâmetro
Estrutura de saída 3:
  • pPropertyEntriesOut[2]. Tipo = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = Qualquer valor diferente de zero para executar o aplicativo, zero para parar

WTS_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 como o seguinte:

  • pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = tamanho da tela
Se você não quiser usar o tamanho de tela padrão, o protocolo deverá retornar E_NOTIMPL.

WTS_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 como o seguinte:

  • pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = nome DLL
Você deve alocar a memória para pstrVal usando a função LocalAlloc .

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

Usado pelo plug-in do 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 WTS_PROPERTY_VALUE no parâmetro pPropertyEntriesIn :

Na saída, passe a seguinte estrutura WTS_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 :

[in] ulNumEntriesIn

Um inteiro que contém o número de estruturas WTS_PROPERTY_VALUE passadas no argumento pPropertyEntriesIn .

[in] ulNumEntriesOut

Um inteiro que contém o número de estruturas WTS_PROPERTY_VALUE passadas no argumento pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

Uma ou mais estruturas WTS_PROPERTY_VALUE que podem ser usadas para ajudar a localizar as informações de propriedade solicitadas.

[out, optional] pPropertyEntriesOut

Uma ou mais estruturas WTS_PROPERTY_VALUE que contêm as informações de propriedade solicitadas.

Retornar valor

Nenhum

Requisitos

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

Confira também

IWRdsProtocolConnection

IWRdsProtocolConnection::QueryProperty

IWTSProtocolConnection

TSMF_SUPPORT_DATA_IN

TSMF_SUPPORT_DATA_OUT

WRDS_DYNAMIC_TIME_ZONE_INFORMATION

WTS_PROPERTY_VALUE