struktur BG_BASIC_CREDENTIALS (bits1_5.h)

  • Artikel

Mengidentifikasi nama pengguna dan kata sandi untuk mengautentikasi.

Sintaks

typedef struct __MIDL_IBackgroundCopyJob2_0001 {
  LPWSTR UserName;
  LPWSTR Password;
} BG_BASIC_CREDENTIALS;

Anggota

UserName

String yang dihentikan null yang berisi nama pengguna untuk diautentikasi. Nama pengguna dibatasi hingga 300 karakter, tidak termasuk terminator null. Format nama pengguna tergantung pada skema autentikasi yang diminta. Misalnya, untuk Dasar, NTLM, dan Negosiasi autentikasi, nama pengguna adalah dari formulir NamaPenggunaDomainName\. Untuk autentikasi Paspor, nama pengguna adalah alamat email. Untuk informasi selengkapnya, lihat Keterangan.

Jika NULL, kredensial default untuk konteks sesi ini digunakan.

Password

String null-terminated yang berisi kata sandi dalam teks biasa. Kata sandi dibatasi hingga 65536 karakter, tidak termasuk terminator null. Kata sandi bisa kosong. Atur ke NULL jika Nama PenggunaNULL. BITS mengenkripsi kata sandi sebelum mempertahankan pekerjaan jika pemutusan jaringan terjadi atau pengguna keluar.

Kata sandi yang dikodekan LIVE ID didukung melalui Negosiasi 2. Untuk informasi selengkapnya tentang ID Langsung, lihat Windows Live ID SDK.

Keterangan

Daftar berikut mengidentifikasi kapan anggota Nama Pengguna dan Kata Sandi diperlukan berdasarkan skema autentikasi yang diminta:

Untuk melindungi informasi nama pengguna dan kata sandi, panggil fungsi SecureZeroMemory , yang ditentukan dalam Winbase.h, untuk menghapus buffer Nama Pengguna dan Kata Sandi setelah Anda menggunakan struktur.

Anda dapat menentukan nama pengguna seperti ini.

  • DomainName\Nama Pengguna. GunakanNama Pengguna DomainName\ jika server berada di domain dan DomainName adalah domain tempat server berada atau merupakan domain tepercaya.
  • ServerName\Nama Pengguna. GunakanNama PenggunaServerName\ jika akun tersebut adalah akun lokal di server. ServerName adalah nama komputer yang mengautentikasi kredensial.
  • Nama Pengguna. Jika Anda hanya menentukan UserName, nama domain default pengguna diawali dengan nama pengguna dan aturan untuk formulirNama PenggunaDomainName\ berlaku. Gunakan opsi ini hanya jika pengguna adalah anggota domain.
  • NULL. Untuk menggunakan kredensial masuk pengguna untuk autentikasi NTLM atau Kerberos, atur UserName ke NULL. Ini hanya berfungsi jika pengguna berada di domain tepercaya. Mengatur UserName ke NULL untuk layanan yang berjalan sebagai akun sistem meneruskan kredensial komputer untuk autentikasi. Opsi ini hanya berfungsi jika domain mengaktifkan autentikasi Kerberos dan Anda memilih Negosiasi sebagai skema autentikasi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Server minimum yang didukung Windows Server 2003
Header bits1_5.h (termasuk Bits.h)
Redistribusi BITS 1.5 di Windows XP

Lihat juga

BG_AUTH_CREDENTIALS_UNION