Fungsi DsBindWithCredA (ntdsapi.h)

Fungsi DsBindWithCred mengikat pengontrol domain menggunakan kredensial yang ditentukan.

Sintaksis

NTDSAPI DWORD DsBindWithCredA(
  [in, optional] LPCSTR                   DomainControllerName,
  [in, optional] LPCSTR                   DnsDomainName,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  [out]          HANDLE                   *phDS
);

Parameter

[in, optional] DomainControllerName

Penunjuk ke string yang dihentikan null yang berisi nama DNS domain yang sepenuhnya memenuhi syarat untuk diikat. Untuk informasi selengkapnya tentang parameter ini, lihat deskripsi DomainControllerName dalam topik DsBind.

[in, optional] DnsDomainName

Penunjuk ke string null-terminated yang berisi nama DNS domain yang sepenuhnya memenuhi syarat untuk diikat. Untuk informasi selengkapnya tentang parameter ini, lihat deskripsi DnsDomainName dalam topik DsBind.

Parameter ini diperlukan untuk mengamankan autentikasi Kerberos.

[in, optional] AuthIdentity

Berisi nilai RPC_AUTH_IDENTITY_HANDLE yang mewakili kredensial yang akan digunakan untuk pengikatan. Si

fungsi DsMakePasswordCredentials digunakan untuk mendapatkan nilai ini. Jika parameter ini NULL, kredensial utas panggilan digunakan.

DsUnBind harus dipanggil sebelum membebaskan handel ini dengan fungsi DsFreePasswordCredentials .

[out] phDS

Alamat nilai HANDLE yang menerima handel pengikatan. Untuk menutup handel ini, teruskan ke fungsi DsUnBind.

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS jika berhasil atau kode kesalahan Windows atau RPC jika tidak. Berikut ini adalah kode kesalahan yang paling umum.

Komentar

Nota

Header ntdsapi.h mendefinisikan DsBindWithCred sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Platform Target	Windows
Header	ntdsapi.h
Pustaka	Ntdsapi.lib
DLL	Ntdsapi.dll

Lihat juga

DOMAIN_CONTROLLER_INFO

Fungsi Pengendali Domain dan Manajemen Replikasi

DsBind

DsFreePasswordCredentials

DsGetDcName

DsMakePasswordCredentials

DsUnBind

Autentikasi Timbayar Menggunakan Kerberos