IMsRdpExtendedSettings::Propriedade Property
Contém uma propriedade nomeada.
Essa propriedade é leitura/gravação.
Sintaxe
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Valor da propriedade
O valor da propriedade nomeada.
| Nome da propriedade | Tipo de dados | Access | Pode ser alterado após o início da conexão | Descrição |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Leitura/Gravação | Sim | Definir essa propriedade como True faz com que o controle do cliente se conecte à sessão filho no computador local em vez de um servidor remoto. Se essa propriedade for definida como true, você não poderá se conectar a um servidor remoto porque todas as conexões serão redirecionadas para o localhost. Para obter mais informações sobre sessões filho, confira Sessões filho. |
| DisableCredentialsDelegation | VT_BOOL | Leitura/Gravação | Não | Se True, as credenciais não serão enviadas para o servidor remoto. |
| EnableFrameBufferRedirection | VT_BOOL | Leitura/Gravação | Não | Se true, o redirecionamento do buffer de quadros será tentado. Para uma conexão de loopback (o mesmo computador é cliente e servidor) o redirecionamento do buffer de quadros permite que a memória do buffer de quadros seja compartilhada entre as sessões. |
| EnableHardwareMode | VT_BOOL | Somente Gravação | Não | Se True, a assistência de hardware com a decodificação de elementos gráficos será tentada. |
| IgnoreCursors | VT_BOOL | Somente Gravação | Não | Se True, os cursores enviados pelo servidor remoto serão ignorados. |
| ManualClipboardSyncEnabled | VT_BOOL | Leitura/Gravação | Sim | Definir essa propriedade como True significa que as áreas de transferência locais e remotas não serão mantidas automaticamente em sincronia. A interface IMsRdpClipboard deve ser usada para sincronizar formatos de área de transferência da área de transferência local para a área de transferência remota e da área de transferência remota para a área de transferência local. |
| ZoomLevel | *VT_UI4 | Leitura/Gravação | Sim | Implementa o recurso Zoom usando o controle ActiveX RDP. O recurso Zoom está disponível no menu Sistema do RDP. A propriedade ZoomLevel não tem efeito no modo RemoteApp e no modo de tela inteira. IMsRdpClientAdvancedSettings::SmartSizing e ZoomLevel são mutuamente exclusivos. |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | Nenhum | Se True, isso faz com que as conexões RemoteApp revertam para a barra de idiomas herdada antes do Windows 8, em vez de sincronizar automaticamente o idioma local com a sessão remota. |
| RedirectTextProcessing | VT_BOOL | W | Nenhum | A partir do Windows 11 23H2, é possível habilitar/desabilitar o redirecionamento do processamento de texto que fornece uma experiência local semelhante para cenários de entrada de texto, por exemplo, IME e emoticons. |
| HvSocketServiceId | VT_BSTR | W | Nenhum | Especifica o campo ServiceId do endereço do soquete Hyper-V para onde o tráfego RDP deve ser enviado. |
| DeviceScaleFactor | VT_UI4 | R/W | Nenhum | Especifica o fator de escala do dispositivo usado na sessão remota. Valores válidos: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Nenhum | Habilita/desabilita o redirecionamento do local do computador local para a sessão remota. |
| AudioCaptureDevice | VT_BSTR | R/W | Nenhum | Especifica a ID do dispositivo de captura de áudio a ser redirecionada do cliente para a sessão remota. Os aplicativos podem usar a mensagem DRV_QUERYFUNCTIONINSTANCEID para determinar a ID do dispositivo de captura de áudio para redirecionamento. Como alternativa, isso pode ser definido como "defautl" para usar o dispositivo padrão ou "none"" para desabilitar a captura de áudio. Por padrão, isso é definido como "default". |
| RailMode | VT_BOOL | R | Nenhum | Informa se essa é uma conexão RemoteApp. ITSRemoteProgram::RemoteProgramMode grava nessa propriedade. |
| EnableRdsAadAuth | VT_BOOL | W | Nenhum | Se True, a Segurança de Autenticação do AAD do RDS será usada. |
| RDGIsKDCProxy | VT_BOOL | W | Nenhum | Se True, informa ao cliente para usar o Gateway de Área de Trabalho Remota (se especificado) como um Servidor proxy do KDC. |
| UseURCP | VT_BOOL | R/W | Nenhum | Se for True, essa propriedade habilitará o Protocolo de Controle de Taxa Universal para conexões de Área de Trabalho Remota baseadas em UDP. Atualmente, ele está desabilitado por padrão. É recomendável habilitá-lo se o UDP estiver em uso. |
| DesktopScaleFactor | VT_UI4 | R/W | Nenhum | Especifica o fator de escala do dispositivo usado na sessão remota. O valor deve estar entre 100 e 500 (porcentagem). |
| RedirectedAuthentication | VT_BOOL | W | Nenhum | Se True, o Remote Credential Guard está habilitado. |
| RestrictedLogon | VT_BOOL | W | Nenhum | Se True, o modo Administrador Restrito está habilitado. |
| AudioPlaybackDevice | VT_BSTR | R/W | Nenhum | Especifica a ID do dispositivo de reprodução de áudio no computador local. Os aplicativos podem usar a mensagem DRV_QUERYFUNCTIONINSTANCEID para determinar a ID do dispositivo de reprodução de áudio para redirecionamento. "Como alternativa, isso pode ser definido como ""default"" para usar o dispositivo padrão ou "none"" para desabilitar a reprodução de áudio. Por padrão, isso é definido como ""default"". " |
| SelectedMonitors | VT_BSTR | R/W | Nenhum | Uma lista delimitada por vírgulas ou delimitada por colunas da ID do monitor para identificar os monitores selecionados onde exibir a sessão remota. A primeira ID da lista será tratada como o monitor primário na sessão remota. |
| WslgModeEnabled | VT_BOOL | W | Nenhum | Se True, a sessão será uma sessão WSLg. Espera-se que as seguintes propriedades sejam fornecidas:
Veja a documentação https://github.com/microsoft/wslg do WSLg. |
| ShowSessionDiagnostics | VT_BOOL | W | Sim | Gravar True nessa propriedade imediatamente mostra uma caixa de diálogo com informações detalhadas sobre a sessão remota. Essa propriedade deve ser um mecanismo de depuração. Ele está sujeito a alterações e remoção. |
| PrintingProgressMode | VT_UI4 | R/W | Nenhum | Valores possíveis:
|
| CorrelationId | VT_BOOL | W | Nenhum | Substitui o valor retornado por IMsRdpClientNonScriptable8::CorrelationId. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Nenhum | Se True, a sessão remota será apresentada usando DirectX somente sem fallback para GDI. Essa propriedade não se aplica a sessões de aplicativo remoto. Observação: essa propriedade está sujeita à remoção em versões futuras do Windows, pois o modo somente DirectX pode se tornar a única opção disponível. Atualmente, esse é um recurso de visualização que não deve ser habilitado no código de produção. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Nenhum | Essa propriedade não tem mais suporte. Ele está sujeito à remoção em versões futuras do Windows. Não use essa propriedade. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Nenhum | Se True e a propriedade ServerSupportsEdgeActions for True, comandos adicionais serão mostrados na barra de ferramentas de conexão da sessão remota. |
| TSGTransportIsUsed | VT_BOOL | R | N/D | Se True, um gateway de Área de Tabalho Remota estará em uso para a sessão remota associada. |
| DiagnosticsInfo | VT_BSTR | W | Nenhum | Uma cadeia de caracteres hexadecimal que representa o campo rdpCorrelationInfo.correlationId da PDU da Solicitação de Conexão X.224 do Cliente. |
| EndpointFedAuth | VT_BSTR | W | Nenhum | O token usado para autenticação RDSTLS federada baseada em declaração. |
| AllowAxToContainerEvents | VT_BOOL | W | Nenhum | Essa propriedade foi adicionada ao Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | N/D | Propriedade somente leitura para determinar se a sessão remota tem a funcionalidade RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411. |
| AppContainerID | VT_BSTR | W | Nenhum | A ID do AppContainer passada para IWorkspaceScriptable3::StartWorkspaceEx2 quando IMsRdpClientNonScriptable8::StartWorkspaceExtension for invocado. Observação: o painel de controle Conexão de RemoteApp e Área de Trabalho não está mais em desenvolvimento ativo. Ele pode estar alterado ou indisponível em versões futuras do Windows. O uso dessa API não é recomendado. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Nenhum | Se True, a movimentação do mouse gerada programaticamente na sessão remota será ignorada. Mais precisamente, a PDU de Atualização de Posição do Ponteiro não será aplicada. Consulte https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Nenhum | Essa propriedade não tem mais suporte. Ele está sujeito à remoção em versões futuras do Windows. Não use essa propriedade. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Nenhum | Se True, as informações do monitor estendido (por exemplo, EDIDs) são enviadas para a sessão remota ao sincronizar as configurações de exibição. |
| ID do Espaço de Trabalho | VT_BSTR | W | Nenhum | O identificador exclusivo da conexão em Conexões de RemoteApp e Área de Trabalho às quais a sessão remota pertence. |
| ShowConnectionInformation | VT_BOOL | W | Sim | Gravar True nessa propriedade mostra a caixa de diálogo Informações de Conexão. |
| WslgSharedMemoryPath | VT_BSTR | W | Nenhum | O caminho para o objeto de sessão de memória para compartilhar o buffer de gráficos com a máquina virtual WSLg. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Nenhum | O GUID associado à VM em execução que hospeda o aplicativo remoto. Gravar essa propriedade resulta em um melhor desempenho para aplicativos remotos em execução em uma VM local devido ao compartilhamento de memória. |
| KDCProxyName | VT_BSTR | W | Nenhum | "Especifica o nome de domínio totalmente qualificado de um servidor Proxy do Centro de Distribuição de Chaves (KDC). O Proxy do KDC permite que o cliente RDP use o protocolo de autenticação Kerberos quando não puder acessar um KDC diretamente. Exemplo do valor da propriedade: ""kdc.contoso.com". Para obter mais informações, confira: Configurar um proxy do Centro de Distribuição de Chaves Kerberos, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | Nenhum | Se True, os gestos em telas multitoques não serão enviados para o servidor remoto. Por padrão, isso é definido como False. |
| HvSocketEnabled | VT_BOOL | W | Nenhum | Se True, o nome do servidor remoto, se for um GUID, será interpretado como o campo VmId do endereço do soquete Hyper-V para onde o tráfego RDP deve ser enviado. Por padrão, isso é definido como False. Para obter mais informações sobre os endereços do soquete Hyper-V, veja Associar a um soquete Hyper-V. |
| MultipenRemotingSupported | VT_BOOL | W | Nenhum | Se True, há suporte para a injeção simultânea de entrada de até quatro dispositivos de caneta na sessão remota. Por padrão, isso é definido como False. |
| ShowGatewayInformation | VT_BOOL | W | Sim | Gravar True nessa propriedade mostra uma caixa de diálogo mostrando informações sobre o gateway de Área de Trabalho Remota. Windows 11 22H2 e superior: essa propriedade não tem mais suporte e foi substituída pela propriedade ShowConnectionInformation. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 8 |
| Servidor mínimo com suporte |
Windows Server 2012 |
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting é definido como 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting é definido como A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting é definido como 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings é definido como 302D8188-0052-4807-806A-362B628F9AC5 |
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