Compartilhar via


Propriedade IMsTscAx::UserName

Especifica a credencial de logon de 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 de erro

Retorne S_OK se tiver êxito.

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 Logon do Windows 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 marcar se o controle estiver 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 do Visual Basic e de script.

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_IMsTscAx é definido como 8C11EFAE-92C3-11D1-BC1E-00C04FA31489

Confira também

Imsrdpclient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

Imstscax