Método IRemoteDesktopClientSettings::SetRdpProperty (rdpappcontainerclient.h)
Define o valor de uma única propriedade RDP nomeada.
Sintaxe
HRESULT SetRdpProperty(
[in] BSTR propertyName,
[in] VARIANT value
);
Parâmetros
[in] propertyName
Uma cadeia de caracteres que especifica o nome da propriedade.
Os valores possíveis são.
"sessão administrativa" (booliano)
Especifica se a sessão é uma sessão administrativa. Esse pode ser um dos valores a seguir.
false
A sessão não é uma sessão administrativa.
True
A sessão é uma sessão administrativa.
"permitir suavização de fonte" (booliano)
Especifica se a suavização de fonte é permitida na sessão remota. Esse pode ser um dos valores a seguir.
false
A suavização de fonte não é permitida.
True
A suavização de fonte é permitida.
"endereço completo alternativo" (Cadeia de caracteres)
Especifica um nome alternativo ou endereço IP do computador remoto ao qual você deseja se conectar.
"audiocapturemode" (booliano)
Especifica o modo de captura de entrada de áudio. Esse pode ser um dos valores a seguir.
false
Não capture a entrada de áudio.
True
Capturar entrada de áudio.
"audiomode" (Número)
Especifica onde os sons são reproduzidos. Esse pode ser um dos valores a seguir.
0
Reproduzir sons no computador cliente.
1
Reproduzir sons no computador host.
2
Não toque sons.
"Nível de autenticação" (Número)
Especifica o nível de autenticação da sessão remota. Esse pode ser um dos valores a seguir.
0
Nenhum.
1
Autenticação necessária.
2
Autenticação negociável.
3
Autenticação não especificada.
"tipo de conexão" (Número)
Especifica o tipo de conexão Esse pode ser um dos valores a seguir.
1
Modem
2
Banda larga de baixa velocidade
3
Satélite
4
Banda larga de alta velocidade
5
WAN
6
LAN
7
Detecção automática
"Endereço do servidor de autenticação baseado em cookie" (Cadeia de caracteres)
Especifica o endereço do servidor de autenticação baseado em cookie.
"desktopheight" (Número)
Especifica a altura, em pixels, da área de trabalho virtual.
"desktopwidth" (Número)
Especifica a largura, em pixels, da área de trabalho virtual.
"desabilitar arrastar janela completa" (booliano)
Especifica se a exibição do conteúdo da janela durante a arrastar está desabilitada. Esse pode ser um dos valores a seguir.
false
habilitado
True
Desabilitado
"disable menu anims" (booliano)
Especifica se a exibição de animações de menu está desabilitada. Esse pode ser um dos valores a seguir.
false
habilitado
True
Desabilitado
"desabilitar temas" (booliano)
Especifica se os temas estão desabilitados. Esse pode ser um dos valores a seguir.
false
habilitado
True
Desabilitado
"desabilitar papel de parede" (booliano)
Especifica se os papéis de parede são exibidos. Esse pode ser um dos valores a seguir.
false
Os papéis de parede são exibidos.
True
Os papéis de parede não são exibidos.
"domain" (String)
Especifica o domínio usado para se conectar à sessão remota.
"enablecredsspsupport" (Boolean)
Especifica se a autenticação baseada em CredSSP deve ser usada para a sessão remota. Esse pode ser um dos valores a seguir.
false
Não use a autenticação baseada em CredSSP.
True
Use a autenticação baseada em CredSSP.
"endereço completo" (Cadeia de caracteres)
Especifica o endereço do computador ao qual está sendo conectado.
"gatewaycredentialssource" (Número)
Especifica a origem das credenciais para o gateway de Área de Trabalho Remota. Esse pode ser um dos valores a seguir.
0
Solicite ao usuário suas credenciais e use a autenticação NTLM.
1
Use uma cartão inteligente para credenciais.
2
Use as credenciais para o usuário conectado no momento.
3
Solicite ao usuário suas credenciais e use a autenticação básica.
4
O usuário selecionará a origem da credencial no logon.
5
Use a autenticação baseada em cookie.
"gatewayhostname" (String)
Especifica o nome do servidor do gateway de Área de Trabalho Remota.
"gatewayprofileusagemethod" (Número)
Especifica o uso do perfil do gateway de Área de Trabalho Remota. Esse pode ser um dos valores a seguir.
0
Use as configurações de perfil do gateway, se houver.
1
Use as configurações explícitas do gateway, mesmo que exista um perfil de gateway.
"gatewayusagemethod" (Número)
Especifica o uso do gateway de Área de Trabalho Remota. Esse pode ser um dos valores a seguir.
0
Não use um servidor de gateway de Área de Trabalho Remota. A caixa Ignorar o servidor do Gateway de Área de Trabalho Remota para endereços locais marcar está desmarcada.
1
Use o gateway de Área de Trabalho Remota especificado pela propriedade "gatewayhostname".
2
Detecte automaticamente as configurações do servidor de gateway de Área de Trabalho Remota.
3
Use as configurações padrão configurações de uso do gateway de Área de Trabalho Remota.
4
Não use um servidor de gateway de Área de Trabalho Remota. A caixa Ignorar o servidor do Gateway de Área de Trabalho Remota para endereços locais marcar está selecionada.
"mouse de alta resolução" (booliano)
Especifica o modo de resolução para entrada do mouse. Esse pode ser um dos valores a seguir.
false
A entrada do mouse será agrupada. Os dados do mouse serão subsamplodos e enviados de acordo com a taxa de amostragem padrão.
True
A entrada do mouse não será agrupada. Os dados do mouse serão enviados em resolução total.
"loadbalanceinfo" (String)
Contém o cookie de balanceamento de carga usado para escolher o melhor servidor para o computador cliente.
"endereço de página da Web de logon" (Cadeia de caracteres)
Especifica o endereço da página da Web de logon.
"endereço do servidor de pré-autenticação" (Cadeia de caracteres)
Especifica o endereço do servidor de pré-autenticação.
"solicitar credenciais" (booliano)
Especifica se o usuário será solicitado a fornecer suas credenciais. Esse pode ser um dos valores a seguir.
false
O usuário não será solicitado a fornecer credenciais.
True
O usuário será solicitado a fornecer credenciais.
"promptcredentialonce" (Número)
Especifica se o compartilhamento de credenciais para o gateway de Área de Trabalho Remota está habilitado. Esse pode ser um dos valores a seguir.
0
O compartilhamento de credenciais está desabilitado.
1
O compartilhamento de credenciais está habilitado.
"redirectclipboard" (booliano)
Especifica se a área de transferência do cliente é redirecionada para a sessão remota. Esse pode ser um dos valores a seguir.
false
A área de transferência não é redirecionada.
True
A área de transferência é redirecionada.
"redirecionadores" (booliano)
Especifica se as impressoras do cliente são redirecionadas para a sessão remota. Esse pode ser um dos valores a seguir.
false
As impressoras não são redirecionadas.
True
As impressoras são redirecionadas.
"exigir pré-autenticação" (Número)
Especifica se a pré-autenticação é necessária. Esse pode ser um dos valores a seguir.
0
A pré-autenticação não é necessária.
1
A pré-autenticação é necessária.
"url de suporte" (Cadeia de caracteres)
Especifica a URL da qual obter informações de suporte.
Booliano
"usar o nome do servidor de redirecionamento" (booliano)
Especifica se um servidor de redirecionamento é permitido. Esse pode ser um dos valores a seguir.
false
Um servidor de redirecionamento não é permitido.
True
Um servidor de redirecionamento é permitido.
"username" (String)
Especifica o nome de usuário usado para se conectar à sessão remota.
"WinRTEncryptedPassword" (String)
Especifica uma senha criptografada. Para definir essa propriedade, você deve executar as seguintes ações.
- Converta a senha de texto claro em binário usando o método ConvertStringToBinary na classe CryptographicBuffer .
- Defina a propriedade WinRTPasswordEncoding usando um valor equivalente para o parâmetro de codificação que você passou para o método ConvertStringToBinary na etapa 1.
- Chame o método DataProtectionProvider(String) passando "LOCAL=user" para a cadeia de caracteres de entrada.
- Chame o método ProtectAsync para criptografar a cadeia de caracteres binária que contém a senha.
- Converta o objeto CryptographicBuffer retornado pelo método ProtectAsync em um valor codificado em Base64 usando o método EncodeToBase64String .
- Defina essa propriedade (WinRTEncryptedPassword) com a cadeia de caracteres codificada em Base64 obtida na etapa 5.
"WinRTPasswordEncoding" (Número)
Especifica o tipo de codificação que pode ser aplicado a uma senha criptografada. Esse pode ser um dos valores a seguir. O valor padrão é 1. Essa propriedade deve ser definida antes de definir a propriedade WinRTEncryptedPassword .
0
UTF8
1
UTF16LE
2
UTF16BE
"ID do workspace" (Cadeia de caracteres)
Especifica o identificador do workspace RemoteApp and Desktop Connection do qual esse arquivo RDP foi publicado como parte.
[in] value
O novo valor da propriedade.
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 | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Windows |
| Cabeçalho | rdpappcontainerclient.h |
| DLL | MsTscAx.dll |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de