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
- Defina a senha em formato de texto sem formatação na propriedade ClearTextPassword .
- 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.
- 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 |
|
DLL |
|
IID |
IID_IMsTscNonScriptable é definido como c1e6743a-41c1-4a74-832a-0dd06c1c7a0e |