Fungsi DsGetDomainControllerInfoA (ntdsapi.h)

Fungsi DsGetDomainControllerInfo mengambil data tentang pengendali domain di domain.

Sintaksis

NTDSAPI DWORD DsGetDomainControllerInfoA(
  [in]  HANDLE hDs,
  [in]  LPCSTR DomainName,
  [in]  DWORD  InfoLevel,
  [out] DWORD  *pcOut,
  [out] VOID   **ppInfo
);

Parameter

[in] hDs

Berisi handel layanan direktori yang diperoleh dari DSBind atau fungsi DSBindWithCred.

[in] DomainName

Penunjuk ke string null-terminated yang menentukan nama domain.

[in] InfoLevel

Berisi nilai yang menunjukkan versi struktur DS_DOMAIN_CONTROLLER_INFO yang akan dikembalikan. Ini bisa menjadi salah satu nilai berikut.

1

Fungsi ini menyediakan data domain dalam format struktur DS_DOMAIN_CONTROLLER_INFO_1.

2

Fungsi ini menyediakan data domain dalam format struktur DS_DOMAIN_CONTROLLER_INFO_2.

3

Fungsi ini menyediakan data domain dalam format struktur DS_DOMAIN_CONTROLLER_INFO_3.

[out] pcOut

Penunjuk ke variabel DWORD yang menerima jumlah item yang dikembalikan dalam array ppInfo .

[out] ppInfo

Penunjuk ke variabel penunjuk yang menerima array struktur DS_DOMAIN_CONTROLLER_INFO_*. Jenis struktur dalam array ini didefinisikan oleh parameter InfoLevel . Pemanggil harus membebaskan array ini, ketika tidak lagi diperlukan, dengan menggunakan fungsi DsFreeDomainControllerInfo.

Mengembalikan nilai

Jika fungsi mengembalikan data pengendali domain, nilai yang dikembalikan adalah ERROR_SUCCESS. Jika pemanggil tidak memiliki hak istimewa untuk mengakses objek server, nilai yang dikembalikan ERROR_SUCCESS, tetapi struktur DS_DOMAIN_CONTROLLER_INFO bisa kosong.

Jika fungsi gagal, nilai pengembalian dapat menjadi salah satu kode kesalahan berikut.

Komentar

Nota

Header ntdsapi.h mendefinisikan DsGetDomainControllerInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

DS_DOMAIN_CONTROLLER_INFO_1

DS_DOMAIN_CONTROLLER_INFO_2

DS_DOMAIN_CONTROLLER_INFO_3

Fungsi Pengendali Domain dan Manajemen Replikasi

DsBind

DsBindWithCred

DsFreeDomainControllerInfo