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

1. Establezca la contraseña en formato de texto no cifrado en la propiedad ClearTextPassword .
2. 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.
3. 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	MsTscAx.dll
Archivo DLL	MsTscAx.dll
IID	IID_IMsTscNonScriptable se define como c1e6743a-41c1-4a74-832a-0dd06c1c7a0e

Consulte también

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsTscNonScriptable