Propriedade IMsTscAx::UserName

Especifica a credencial de logon do nome de usuário.

Essa propriedade é leitura/gravação.

Syntax

HRESULT put_UserName(
  [in]  BSTR newVal
);

HRESULT get_UserName(
  [out] BSTR *pUserName
);

Valor da propriedade

O novo nome de usuário.

Códigos do Erro

Retornar S _ OK se for bem-sucedido.

Comentários

Definir a propriedade UserName é opcional. Se não for especificado, o usuário poderá fornecer um nome de usuário quando a caixa de diálogo Windows Logon for exibida durante a conexão.

Essa propriedade só poderá ser definida se o controle não estiver no estado conectado. Ele retornará E _ FAIL se for chamado quando o controle estiver conectado. Você pode verificar se o controle está conectado respondendo a eventos de conexão em IMsTscAxEvents ou examinando a propriedade Connected.

O método de propriedade get _ UserName aloca a memória necessária para o buffer apontado pelo parâmetro pVersion. Chamar aplicativos C/C++ deve liberar a memória com uma chamada para a função SysFreeString. Isso não é necessário para clientes Visual Basic e scripts.

Para obter mais informações sobre Conexão Web de Área de Trabalho Remota, consulte Requirements for Conexão Web de Á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 IMsTscAx é definido como _ 8C11EFAE-92C3-11D1-BC1E-00C04FA31489

Confira também

Imsrdpclient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

Imstscax