Fungsi DsGetDcOpenA (dsgetdc.h)

Fungsi DsGetDcOpen membuka operasi enumerasi pengendali domain baru.

Sintaksis

DSGETDCAPI DWORD DsGetDcOpenA(
  [in]           LPCSTR  DnsName,
  [in]           ULONG   OptionFlags,
  [in, optional] LPCSTR  SiteName,
  [in, optional] GUID    *DomainGuid,
  [in, optional] LPCSTR  DnsForestName,
  [in]           ULONG   DcFlags,
  [out]          PHANDLE RetGetDcContext
);

Parameter

[in] DnsName

Penunjuk ke string yang dihentikan null yang berisi nama sistem penamaan domain (DNS) domain untuk menghitung pengontrol domain. Parameter ini tidak dapat null.

[in] OptionFlags

Berisi sekumpulan bendera yang mengubah perilaku fungsi. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

DS_ONLY_DO_SITE_NAME

Hanya pengontrol domain khusus situs yang dijumlahkan.

DS_NOTIFY_AFTER_SITE_RECORDS

Fungsi DsGetDcNext akan mengembalikan nilai ERROR_FILEMARK_DETECTED setelah semua pengontrol domain khusus situs diambil. DsGetDcNext kemudian akan menghitung grup kedua, yang berisi semua pengendali domain di domain, termasuk pengendali domain khusus situs yang terkandung dalam grup pertama.

[in, optional] SiteName

Penunjuk ke string null-terminated yang berisi nama situs tempat klien berada. Parameter ini bersifat opsional dan mungkin NULL.

[in, optional] DomainGuid

Penunjuk ke nilai GUID yang berisi pengidentifikasi domain yang ditentukan oleh DnsName. Pengidentifikasi ini digunakan untuk menangani kasus domain yang diganti namanya. Jika nilai ini ditentukan dan domain yang ditentukan dalam DnsName diganti namanya, fungsi ini mencoba menghitung pengontrol domain di domain yang berisi pengidentifikasi yang ditentukan. Parameter ini bersifat opsional dan mungkin NULL.

[in, optional] DnsForestName

Penunjuk ke string null-terminated yang berisi nama forest yang berisi domain DnsName. Nilai ini digunakan bersama dengan DomainGuid untuk menghitung pengontrol domain jika domain telah diganti namanya. Parameter ini bersifat opsional dan mungkin NULL.

[in] DcFlags

Berisi sekumpulan bendera yang mengidentifikasi jenis pengontrol domain yang akan dijumlahkan. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

DS_FORCE_REDISCOVERY

Memaksa data pengontrol domain yang di-cache untuk diabaikan. Ketika bendera ini tidak ditentukan, DsGetDcOpen mendapatkan enumerasi pengendali domain dari data pengontrol domain yang di-cache.

DS_GC_SERVER_REQUIRED

Mengharuskan pengontrol domain yang dijumlahkan menjadi server katalog global untuk forest domain dengan domain ini sebagai akarnya. Bendera ini tidak dapat digabungkan dengan bendera DS_PDC_REQUIRED.

DS_KDC_REQUIRED

Mengharuskan pengontrol domain enumerasi saat ini menjalankan layanan Pusat Distribusi Kunci Kerberos. Bendera ini tidak dapat digabungkan dengan bendera DS_PDC_REQUIRED atau DS_GC_SERVER_REQUIRED.

DS_ONLY_LDAP_NEEDED

Menentukan bahwa server enumerasi adalah server LDAP. Server belum tentu merupakan pengendali domain. Tidak ada layanan lain yang tersirat untuk hadir di setiap server enumerasi. Server tidak selalu memiliki konfigurasi yang dapat ditulis kontainer atau skema yang dapat ditulis kontainer. Server mungkin belum tentu digunakan untuk membuat atau memodifikasi prinsip keamanan. Bendera ini dapat digunakan dengan bendera DS_GC_SERVER_REQUIRED untuk menghitung server LDAP yang juga menghosting server katalog global. Dalam hal ini, server katalog global yang dijumlahkan belum tentu pengontrol domain dan layanan lain tersirat untuk hadir di setiap server. Jika bendera ini ditentukan, bendera DS_PDC_REQUIRED, DS_TIMESERV_REQUIRED, DS_GOOD_TIMESERV_PREFERRED, DS_DIRECTORY_SERVICES_PREFERED, DS_DIRECTORY_SERVICES_REQUIRED, dan bendera DS_KDC_REQUIRED diabaikan.

DS_PDC_REQUIRED

Mengharuskan pengontrol domain enumerasi menjadi pengontrol domain utama untuk domain. Bendera ini tidak dapat digabungkan dengan bendera DS_GC_SERVER_REQUIRED.

[out] RetGetDcContext

Penunjuk ke nilai HANDLE yang menerima handel konteks enumerasi pengontrol domain. Handel ini digunakan dengan fungsi DsGetDcNext untuk mengidentifikasi operasi enumerasi pengontrol domain. Handel ini diteruskan ke DsGetDcClose untuk menutup operasi enumerasi pengontrol domain.

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS jika berhasil atau kesalahan Win32 atau RPC jika tidak. Kemungkinan nilai kesalahan termasuk yang berikut ini.

Komentar

Persyaratan

Lihat juga

Directory Service Functions

DsGetDcClose

DsGetDcNext

Menghitung Pengendali Domain