Propriedade IMsRdpExtendedSettings::P roperty

Contém uma propriedade nomeada.

Essa propriedade é de 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 dado	Acesso	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 estiver definida como verdadeiro, você não poderá se conectar a um servidor remoto porque todas as conexões serão redirecionadas para localhost. Para obter mais informações sobre sessões filho, consulte 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 quadro será tentado. Para uma conexão de loopback (o mesmo computador é cliente e servidor) o redirecionamento de buffer de quadro permite que a memória do buffer de quadro 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. Em vez disso, 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 a á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 do sistema de 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 exclusivas.
DisableSeamlessLanguageBar	VT_BOOL	R/W	Não	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	Não	A partir do Windows 11 23H2, habilita/desabilita 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	Não	Especifica o campo ServiceId do soquete Hyper-Vendereço para onde o tráfego RDP deve ser enviado.
DeviceScaleFactor	VT_UI4	R/W	Não	Especifica o fator de escala do dispositivo usado na sessão remota. Valores válidos: 100, 140, 180
EnableLocationRedirection	VT_BOOL	R/W	Não	Habilita/desabilita o redirecionamento do local do computador local para a sessão remota.
AudioCaptureDevice	VT_BSTR	R/W	Não	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 redirecionar. Como alternativa, isso pode ser definido como "padrão" para usar o dispositivo padrão ou "nenhum"" para desabilitar a captura de áudio. Por padrão, isso é definido como "padrão".
RailMode	VT_BOOL	R	Não	Informa se essa é uma conexão RemoteApp. ITSRemoteProgram::RemoteProgramMode grava nessa propriedade.
EnableRdsAadAuth	VT_BOOL	W	Não	Se True, de Segurança de Autenticação do AAD do RDS será usado.
RDGIsKDCProxy	VT_BOOL	W	Não	Se True, instruir o cliente a usar o Gateway de Área de Trabalho Remota (se especificado) como um servidor proxy KDC .
UseURCP	VT_BOOL	R/W	Não	Se 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	Não	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	Não	Se True, do Remote Credential Guard está habilitado.
RestrictedLogon	VT_BOOL	W	Não	Se True, modo de administrador restrito estará habilitado.
AudioPlaybackDevice	VT_BSTR	R/W	Não	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 redirecionar. "Como alternativa, isso pode ser definido como ""padrão"" para usar o dispositivo padrão ou "nenhum"" para desabilitar a reprodução de áudio. Por padrão, isso é definido como ""padrão". "
SelectedMonitors	VT_BSTR	R/W	Não	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	Não	Se True, a sessão será uma sessão WSLg. Espera-se que as seguintes propriedades sejam fornecidas: WslgSharedMemoryPath HvSocketEnabled HvSocketServiceId Consulte a documentação do WSLg https://github.com/microsoft/wslg.
ShowSessionDiagnostics	VT_BOOL	W	Sim	Escrever True para essa 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	Não	Valores possíveis: 0: a caixa de diálogo de progresso mostrada quando a impressão está desabilitada 1: a caixa de diálogo de progresso mostrada ao imprimir contém informações básicas 2: a caixa de diálogo de progresso mostrada ao imprimir contém informações detalhadas
CorrelationId	VT_BOOL	W	Não	Substitui o valor retornado por IMsRdpClientNonScriptable8::CorrelationId.
RequestUseNewOutputPresenter	VT_BOOL	W	Não	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	Não	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	Não	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/A	Se True, um gateway de Área de Trabalho Remota estará em uso para a sessão remota associada.
DiagnosticsInfo	VT_BSTR	W	Não	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	Não	O token usado parade autenticação RDSTLS de federados baseados em declaração.
AllowAxToContainerEvents	VT_BOOL	W	Não	Essa propriedade foi adicionada ao Windows 11 22H2. Se false (comportamento padrão a partir do Windows 11 22H2), as combinações de teclas CTRL+ALT+ARROW serão enviadas para a sessão remota. Se true (comportamento padrão antes do Windows 11 22H2), as combinações de teclas CTRL+ALT+ARROW geram um evento IMsTscAxEvents::OnFocusReleased para o aplicativo.
ServerSupportsEdgeActions	VT_BOOL	R	N/A	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	Não	A ID do AppContainer passada para IWorkspaceScriptable3::StartWorkspaceEx2 quando IMsRdpClientNonScriptable8::StartWorkspaceExtension é invocado. Observação: o painel de controle RemoteApp e Conexões de Á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 é desencorajado.
IgnoreServerGeneratedMouseMoves	VT_BOOL	R/W	Não	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 é aplicada. Consulte https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c.
RDmiDiagnosticsUrl	VT_BSTR	W	Não	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	Não	Se True, as informações do monitor estendido (por exemplo, EDIDs) serão enviadas para a sessão remota ao sincronizar as configurações de exibição.
Workspace Id	VT_BSTR	W	Não	O identificador exclusivo da conexão em RemoteApp e Conexões de Área de Trabalho ao qual a sessão remota pertence.
ShowConnectionInformation	VT_BOOL	W	Sim	Gravar True nesta propriedade mostra a caixa de diálogo Informações de Conexão.
WslgSharedMemoryPath	VT_BSTR	W	Não	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	Não	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	Não	"Especifica o nome de domínio totalmente qualificado de um servidor proxy do Centro de Distribuição de Chaves (KDC). O Proxy 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, consulte: 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	Não	Se True, os gestos em telas com vários toques não serão enviados para o servidor remoto. Por padrão, isso é definido como False.
HvSocketEnabled	VT_BOOL	W	Não	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 Hyper-V endereços do soquete, consulte Associar a um soquete Hyper-V.
MultipenRemotingSupported	VT_BOOL	W	Não	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 nesta propriedade mostra uma caixa de diálogo mostrando informações sobre o gateway de Área de Trabalho Remota. Windows 11 22H2 e superiores: essa propriedade não tem mais suporte e foi substituída pela propriedade ShowConnectionInformation.
DisableAutoReconnectComponent	VT_BOOL	W	Não	Se True, a conexão do servidor não será desconectada e reconectada automaticamente quando a configuração de rede for alterada. Por padrão, isso é definido como False.
RedirectUsbDrive	VT_UI4	R/W	Não	Introduzido no Windows 11 versão 24H2. Quando não definido ou definido como 0, a unidade de pen drive é redirecionada como direção da unidade. Quando definido como 1, todas as unidades de pen são redirecionadas automaticamente como dispositivos USB. Quando definido como 2, as unidades de pen são listadas como dispositivos USB, os usuários podem optar por redirecioná-las por meio do redirecionamento USB da interface do usuário (caixa de diálogo do dispositivo na barra de conexão) ou da entrada de arquivo RDP "UsbDevicesToRedirect".
protocolos de segurança permitidos	VT_BSTR	W	Não	Introduzido no Windows 11 versão 24H2. Essa propriedade é usada para restringir a lista de protocolos de segurança que o cliente pode negociar. A lista real de protocolos negociados é determinada por outras configurações e pelo cenário de conexão e pode ser menor do que a lista especificada nesta propriedade. O valor deve conter a lista de nomes de protocolo separados por ';' ou o valor pode ser definido como "", o que significa que todos os protocolos normalmente negociados são permitidos. Os nomes de protocolo com suporte são: "TLS", "CredSSP", "RDSTLS" e "RdS AAD Auth" O valor padrão é "".
AllowRelativeMouseMode	VT_BOOL	R/W	Não	Introduzido no Windows 11 versão 24H2. Se True, os movimentos do mouse serão representados em relação à posição atual do mouse.
RemoteAppMouseMoveInject	VT_BOOL	W	Não	Introduzido no Windows 11 versão 24H2. Gravar True nessa propriedade força a injeção de uma movimentação de mouse quando o cursor sai de uma janela RemoteApp. Isso se destina a ser uma solução alternativa para um bug de dica de ferramenta.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Biblioteca de tipos	MsTscAx.dll
DLL	MsTscAx.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

Consulte também

IMsRdpExtendedSettings