Compartilhar via


Propriedade IMsTscNonScriptable::ClearTextPassword

Define a senha de controle ActiveX da Área de Trabalho Remota em formato de texto sem formatação.

Essa propriedade é somente gravação.

Syntax

HRESULT put_ClearTextPassword(
  [in] BSTR newClearTextPass
);

Valor da propriedade

A senha a ser usada para se conectar, especificada em formato de texto sem formatação.

Códigos de erro

Retorne S_OK se tiver êxito.

Comentários

A senha é passada para o servidor no canal de comunicações RDP criptografado com segurança. Depois que uma senha de texto não criptografado for definida, ela não poderá ser recuperada em formato de texto sem formatação.

A propriedade ClearTextPassword só pode ser definida quando o controle ActiveX da Área de Trabalho Remota não está no estado conectado. A configuração dessa propriedade falhará se o controle estiver conectado. Para marcar para o estado conectado, recupere a propriedade IMsTscAx::Connected.

Você também pode chamar esse método para definir uma senha de texto não criptografado antes de convertê-la em uma senha codificada portátil ou em uma senha codificada binária (nãoportável). No entanto, observe que as senhas codificadas não devem ser consideradas criptografadas com segurança.

Se você primeiro chamar esse método para definir uma senha em formato de texto sem formatação, poderá converter a senha em formato codificado.

Para converter uma senha de texto sem formatação em formato codificado

  1. Defina a senha em formato de texto sem formatação na propriedade ClearTextPassword .
  2. Para recuperar a senha no formato codificado binário (nãoportável), recupere a propriedade BinaryPassword e as propriedades BinarySalt . A parte de senha codificada e a parte de sal são necessárias para definir uma senha no formato codificado binário.
  3. Para recuperar a senha em formato codificado portátil, recupere o método PortablePassword e as propriedades PortableSalt . Ambas as partes são necessárias para definir uma senha no formato codificado portátil.

Depois de seguir as três etapas anteriores, você pode definir a senha no formato codificado definindo as propriedades BinaryPassword e BinarySalt ou PortablePassword e PortableSalt . Ambas as partes são necessárias.

Para habilitar o logon automático, você também deve definir as propriedades UserName e Domain . Se a senha não conseguir autenticar o usuário, a caixa de diálogo Logon do Windows será exibida no servidor para solicitar a senha ao usuário.

Para obter mais informações sobre a Conexão da Web da Área de Trabalho Remota, consulte Requisitos para conexão da Web da Área de Trabalho Remota.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Biblioteca de tipos
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsTscNonScriptable é definido como c1e6743a-41c1-4a74-832a-0dd06c1c7a0e

Confira também

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

Imstscnonscriptable