Properti IMsTscAx::UserName

Menentukan kredensial masuk nama pengguna.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_UserName(
  [in]  BSTR newVal
);

HRESULT get_UserName(
  [out] BSTR *pUserName
);

Nilai properti

Nama pengguna baru.

Kode kesalahan

Kembalikan S_OK jika berhasil.

Keterangan

Mengatur properti UserName bersifat opsional. Jika tidak ditentukan, pengguna dapat memberikan nama pengguna saat kotak dialog Masuk Windows muncul selama koneksi.

Properti ini dapat diatur hanya jika kontrol tidak dalam status tersambung. Ini mengembalikan E_FAIL jika dipanggil saat kontrol tersambung. Anda dapat memeriksa apakah kontrol terhubung dengan merespons peristiwa koneksi di IMsTscAxEvents atau memeriksa properti Tersambung .

Metode properti get_UserName mengalokasikan memori yang diperlukan untuk buffer yang ditunjukkan oleh parameter pVersion . Memanggil aplikasi C/C++ harus membebaskan memori dengan panggilan ke fungsi SysFreeString . Ini tidak diperlukan untuk Visual Basic dan klien pembuatan skrip.

Untuk informasi selengkapnya tentang Sambungan Web Desktop Jauh, lihat Persyaratan untuk Koneksi Web Desktop Jarak Jauh.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows Vista
Server minimum yang didukung
Windows Server 2008
Pustaka jenis
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsTscAx didefinisikan sebagai 8C11EFAE-92C3-11D1-BC1E-00C04FA31489

Lihat juga

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsTscAx