Propiedad IMsTscNonScriptable::ClearTextPassword
Establece la contraseña de control ActiveX de Escritorio remoto en formato de texto no cifrado.
Esta propiedad es de solo escritura.
Sintaxis
HRESULT put_ClearTextPassword(
[in] BSTR newClearTextPass
);
Valor de propiedad
Contraseña que se va a usar para conectarse, especificada en formato de texto no cifrado.
Códigos de error
Devuelve S_OK si se ejecuta correctamente.
Comentarios
La contraseña se pasa al servidor en el canal de comunicaciones RDP cifrados de forma segura. Después de establecer una contraseña de texto no cifrado, no se puede recuperar en formato de texto no cifrado.
La propiedad ClearTextPassword solo se puede establecer cuando el control ActiveX de Escritorio remoto no está en estado conectado. Si el control está conectado, se produce un error al establecer esta propiedad. Para comprobar el estado conectado, recupere la propiedad IMsTscAx::Connected .
También puede llamar a este método para establecer una contraseña de texto no cifrado antes de convertirla en una contraseña codificada portable o en una contraseña codificada binaria (noportable). Sin embargo, tenga en cuenta que las contraseñas codificadas no se deben considerar cifradas de forma segura.
Si primero llama a este método para establecer una contraseña en formato de texto no cifrado, puede convertir la contraseña en formato codificado.
Para convertir una contraseña de texto no cifrado en formato codificado
- Establezca la contraseña en formato de texto no cifrado en la propiedad ClearTextPassword .
- Para recuperar la contraseña en formato codificado binario (noportable), recupere la propiedad BinaryPassword y las propiedades BinarySalt . Tanto la parte de contraseña codificada como la parte de sal son necesarias para establecer una contraseña en formato codificado binario.
- Para recuperar la contraseña en formato codificado portátil, recupere el método PortablePassword y las propiedades PortableSalt . Ambas partes son necesarias para establecer una contraseña en formato codificado portátil.
Después de seguir los tres pasos anteriores, puede establecer la contraseña en formato codificado estableciendo las propiedades BinaryPassword y BinarySalt o PortablePassword y PortableSalt . Ambas partes son necesarias.
Para habilitar el inicio de sesión automático, también debe establecer las propiedades UserName y Domain . Si la contraseña no puede autenticar al usuario, el cuadro de diálogo Inicio de sesión de Windows se muestra en el servidor para solicitar al usuario la contraseña.
Para obtener más información sobre la conexión web de Escritorio remoto, consulte Requisitos para la conexión web de Escritorio remoto.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Biblioteca de tipos |
|
| Archivo DLL |
|
| IID |
IID_IMsTscNonScriptable se define como c1e6743a-41c1-4a74-832a-0dd06c1c7a0e |