IMsRdpExtendedSettings:propriedade :P roperty
Contém uma propriedade nomeada.
Esta 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 do imóvel
O valor da propriedade nomeada.
| Nome da propriedade | Tipo de dados | 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 de cliente se conecte à sessão filho na máquina local em vez de um servidor remoto. Se essa propriedade estiver definida como true, 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 infantis, consulte sessões infantis. |
| DisableCredentialsDelegação | 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 gráfica for 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 |
| ZoomLevel | * VT_UI4 | Leitura/Gravação | Sim | Implementa o recurso Zoom usando o controle ActiveX RDP. O recurso Zoom está disponível no menu System 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 | Não | Se True, isso fará com que as conexões do RemoteApp revertam para a barra de idiomas herdada de antes do Windows 8, em vez de sincronizar automaticamente o idioma local para a sessão remota. |
| RedirectTextProcessing | VT_BOOL | W | Não | A partir do Windows 11 23H2, habilita/desabilita o redirecionamento de processamento de texto que fornece uma experiência semelhante ao local para cenários de entrada de texto, por exemplo, IME, emoticons. |
| HvSocketServiceId | VT_BSTR | W | Não | Especifica o campo ServiceId do endereço dode soquete de |
| DeviceScaleFactor | VT_UI4 | R/W | Não | Especifica o fator de escala de 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 da máquina local para a sessão remota. |
| AudioCaptureDevice | VT_BSTR | R/W | Não | Especifica o ID do dispositivo de captura de áudio a ser redirecionado do cliente para a sessão remota. Os aplicativos podem usar a mensagem DRV_QUERYFUNCTIONINSTANCEID para determinar o ID do dispositivo de captura de áudio a ser redirecionado. Como alternativa, isso pode ser definido como "padrão" para usar o dispositivo padrão ou ""nenhum"" para desativar a captura de áudio. Por padrão, isso é definido como "padrão". |
| Modo Ferroviário | VT_BOOL | R | Não | Informa se esta é uma conexão RemoteApp. ITSRemoteProgram::RemoteProgramMode grava nesta propriedade. |
| EnableRdsAadAuth | VT_BOOL | W | Não | Se True, RDS AAD Auth Security será usado. |
| RDGIsKDCProxy | VT_BOOL | W | Não | Se True, informa ao cliente para 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 habilita o Protocolo de Controle de Taxa Universal para conexões de Área de Trabalho Remota baseadas em UDP. Atualmente, ele está desativado por padrão. Recomenda-se ativá-lo se o UDP estiver em uso. |
| DesktopScaleFactor | VT_UI4 | R/W | Não | Especifica o fator de escala de dispositivo usado na sessão remota. O valor deve estar entre 100 e 500 (por cento). |
| RedirectedAuthentication | VT_BOOL | W | Não | Se True, do Remote Credential Guard está habilitado. |
| RestrictedLogon | VT_BOOL | W | Não | Se True, modo Administrador Restrito está ativado. |
| AudioPlaybackDevice | VT_BSTR | R/W | Não | Especifica a ID do dispositivo de reprodução de áudio na máquina local. Os aplicativos podem usar a mensagem DRV_QUERYFUNCTIONINSTANCEID para determinar o ID do dispositivo de reprodução de áudio a ser redirecionado. "Como alternativa, isso pode ser definido como ""padrão"" para usar o dispositivo padrão ou ""nenhum"" para desativar a reprodução de áudio. Por padrão, isso é definido como ""default"". " |
| SelectedMonitors | VT_BSTR | R/W | Não | Uma lista delimitada por vírgulas ou semicolunas do ID do monitor para identificar os monitores selecionados onde exibir a sessão remota. O primeiro ID da lista será tratado como o monitor principal na sessão remota. |
| WslgModeEnabled | VT_BOOL | W | Não | Se True, a sessão é uma sessão WSLg. Espera-se que as seguintes propriedades sejam fornecidas:
Consulte a documentação do WSLg https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Sim | Escrever True nesta propriedade mostra imediatamente uma caixa de diálogo com informações detalhadas sobre a sessão remota. Esta propriedade destina-se a ser um mecanismo de depuração. Está sujeito a alterações e remoção. |
| PrintingProgressMode | VT_UI4 | R/W | Não | Valores possíveis:
|
| 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 é apresentada usando DirectX somente sem fallback para GDI. Esta propriedade não se aplica a sessões de aplicativos remotos. Nota: esta propriedade está sujeita a remoção em versões futuras do Windows, uma vez que o modo apenas DirectX pode tornar-se 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 | Esta propriedade não é mais suportada. Está sujeito a remoção em versões futuras do Windows. Não utilize esta 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 está 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 de solicitação de conexão X.224 do cliente . |
| Ponto de extremidadeFedAuth | VT_BSTR | W | Não | O token usado para autenticação de RDSTLS federada baseada em declarações. |
| AllowAxToContainerEvents | VT_BOOL | W | Não | Esta propriedade foi adicionada no Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | N/A | Propriedade somente leitura para determinar se a sessão remota tem a capacidade 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 AppContainer passada para IWorkspaceScriptable3::StartWorkspaceEx2 quando IMsRdpClientNonScriptable8::StartWorkspaceExtension é invocado. Observação: o painel de controle Conexões de RemoteApp e Área de Trabalho não está mais em desenvolvimento ativo. Pode ser alterado ou não estar disponível em versões futuras do Windows. O uso desta API é desencorajado. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Não | Se True, o movimento do mouse gerado programaticamente na sessão remota será ignorado. Mais precisamente, a PDU de atualização de posição do ponteiro não é aplicada. Ver https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Não | Esta propriedade não é mais suportada. Está sujeito a remoção em versões futuras do Windows. Não utilize esta propriedade. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Não | Se True, as informações estendidas do monitor (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 | Não | O identificador exclusivo da conexão em Conexões de RemoteApp e Área de Trabalho ao qual a sessão remota pertence. |
| ShowConnectionInformation | VT_BOOL | W | Sim | Escrever True para esta 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 gráfico com a máquina virtual WSLg. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Não | O GUID associado à VM em execução que hospeda o aplicativo remoto. Escrever essa propriedade resulta em 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 do imóvel: ""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, gestos em telas multitoque não serão enviados para o servidor remoto. Por padrão, isso é definido como Falso. |
| 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 o qual o tráfego RDP deve ser enviado. Por padrão, isso é definido como Falso. Para obter mais informações sobre endereços de soquete Hyper-V, consulte Vincular a um soquete Hyper-V. |
| MultipenRemotingSuportado | VT_BOOL | W | Não | Se True, a injeção simultânea de entrada de até quatro dispositivos de caneta é suportada na sessão remota. Por padrão, isso é definido como Falso. |
| ShowGatewayInformation | VT_BOOL | W | Sim | Escrever True nesta propriedade mostra uma caixa de diálogo mostrando informações sobre o gateway da Área de Trabalho Remota. Windows 11 22H2 e superior: esta propriedade não é mais suportada e foi substituída pelo ShowConnectionInformation propriedade. |
| DisableAutoReconnectComponent | VT_BOOL | W | Não | Se True, a conexão do servidor não será desconectada e reconectada automaticamente quando a configuração da rede for alterada. Por padrão, isso é definido como Falso. |
| RedirectUsbDrive | VT_UI4 | R/W | Não | Introduzido no Windows 11 versão 24H2. Quando não está definido ou definido como 0, o pen drive USB redireciona como direção da unidade. Quando definido como 1, todos os pen drives USB são redirecionados como dispositivos USB automaticamente. Quando definido como 2, os pen drives USB são listados como dispositivos USB, os usuários podem optar por redirecioná-los através do redirecionamento USB da interface do usuário (caixa de diálogo do dispositivo na barra de conexão) ou entrada de arquivo RDP "UsbDevicesToRedirect". |
| Protocolos de segurança permitidos | VT_BSTR | W | Não | Introduzido no Windows 11 versão 24H2. Esta 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 definições de configuração 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 suportados 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 são representados em relação à posição atual do mouse. |
| RemoteAppMouseMoveInject | VT_BOOL | W | Não | Introduzido no Windows 11 versão 24H2. Escrever True para esta propriedade força a injeção de um movimento do mouse quando o cursor sai de uma janela do RemoteApp. Destina-se a ser uma solução alternativa para um bug de dica de ferramenta. |
Requerimentos
| Exigência | Valor |
|---|---|
| Cliente mínimo suportado |
Janelas 8 |
| Servidor mínimo suportado |
Windows Server 2012 |
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting é definida como 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting é definida como A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting é definida como 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings é definido como 302D8188-0052-4807-806A-362B628F9AC5 |