Fungsi DsBindW (ntdsapi.h)

Fungsi DsBind mengikat pengontrol domain.DsBind menggunakan kredensial proses default untuk mengikat pengontrol domain. Untuk menentukan kredensial alternatif, gunakan fungsi DsBindWithCred.

Sintaksis

NTDSAPI DWORD DsBindW(
  [in, optional] LPCWSTR DomainControllerName,
  [in, optional] LPCWSTR DnsDomainName,
  [out]          HANDLE  *phDS
);

Parameter

[in, optional] DomainControllerName

Penunjuk ke string null-terminated yang berisi nama pengendali domain yang akan diikat. Nama ini bisa menjadi nama pengendali domain atau nama DNS yang sepenuhnya memenuhi syarat dari pengendali domain. Salah satu jenis nama dapat, secara opsional, didahului oleh dua karakter garis miring terbalik. Semua contoh berikut mewakili nama pengendali domain yang diformat dengan benar:

• "FAB-DC-01"
• "\\FAB-DC-01"
• "FAB-DC-01.fabrikam.com"
• "\\FAB-DC-01.fabrikam.com"

Parameter ini dapat null. Untuk informasi selengkapnya, lihat Keterangan.

[in, optional] DnsDomainName

Penunjuk ke string null-terminated yang berisi nama DNS domain yang sepenuhnya memenuhi syarat untuk diikat. Parameter ini dapat null. Untuk informasi selengkapnya, lihat Keterangan.

[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

Perilaku fungsi DsBind ditentukan oleh konten parameter DomainControllerName dan DnsDomainName. Daftar berikut menjelaskan perilaku fungsi ini berdasarkan konten parameter ini.

DomainControllerName	DnsDomainName	Deskripsi
NULL	NULL	DsBind akan mencoba mengikat server katalog global di forest komputer lokal.
(nilai)	NULL	DsBind akan mencoba mengikat pengontrol domain yang ditentukan oleh parameter DomainControllerName.
NULL	(nilai)	DsBind akan mencoba mengikat pengontrol domain apa pun di domain yang ditentukan oleh parameter DnsDomainName.
(nilai )	(nilai)	Parameter DomainControllerName lebih diutamakan. DsBind akan mencoba mengikat pengontrol domain yang ditentukan oleh parameter DomainControllerName.

 

Nota

Header ntdsapi.h mendefinisikan DsBind 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

DsBindWithCred

DsGetDcName

DsUnBind