struktur DOMAIN_CONTROLLER_INFOW (dsgetdc.h)

Artikel
11/20/2024

Struktur DOMAIN_CONTROLLER_INFO digunakan dengan fungsi DsGetDcName untuk menerima data tentang pengendali domain.

Sintaksis

typedef struct _DOMAIN_CONTROLLER_INFOW {
#if ...
  wchar_t *DomainControllerName;
#else
  LPWSTR  DomainControllerName;
#endif
#if ...
  wchar_t *DomainControllerAddress;
#else
  LPWSTR  DomainControllerAddress;
#endif
  ULONG   DomainControllerAddressType;
  GUID    DomainGuid;
#if ...
  wchar_t *DomainName;
#else
  LPWSTR  DomainName;
#endif
#if ...
  wchar_t *DnsForestName;
#else
  LPWSTR  DnsForestName;
#endif
  ULONG   Flags;
#if ...
  wchar_t *DcSiteName;
#else
  LPWSTR  DcSiteName;
#endif
#if ...
  wchar_t *ClientSiteName;
#else
  LPWSTR  ClientSiteName;
#endif
} DOMAIN_CONTROLLER_INFOW, *PDOMAIN_CONTROLLER_INFOW;

Anggota

DomainControllerName

Penunjuk ke string yang dihentikan null yang menentukan nama komputer pengontrol domain yang ditemukan. Nama komputer yang dikembalikan diawali dengan "\". Nama gaya DNS, misalnya, "\phoenix.fabrikam.com", dikembalikan, jika tersedia. Jika nama gaya DNS tidak tersedia, nama gaya datar (misalnya, "\phoenix") dikembalikan. Contoh ini akan berlaku jika domain adalah domain Windows NT 4.0 atau jika domain tidak mendukung keluarga IP protokol.

DomainControllerAddress

Penunjuk ke string yang dihentikan null yang menentukan alamat pengontrol domain yang ditemukan. Alamat diawali dengan "\". String ini adalah salah satu jenis yang ditentukan oleh DomainControllerAddressType anggota.

DomainControllerAddressType

Menunjukkan jenis string yang terkandung dalam DomainControllerAddress anggota. Ini bisa menjadi salah satu nilai berikut.

DS_INET_ADDRESS

Alamatnya adalah alamat IP string (misalnya, "\157.55.94.74") dari pengendali domain.

DS_NETBIOS_ADDRESS

Alamatnya adalah nama NetBIOS, misalnya, "\phoenix", dari pengendali domain.

DomainGuid

GUID domain. Anggota ini nol jika pengendali domain tidak memiliki GUID Domain; misalnya, pengendali domain bukan pengontrol domain Windows 2000.

DomainName

Penunjuk ke string null-terminated yang menentukan nama domain. Nama gaya DNS, misalnya, "fabrikam.com", dikembalikan jika tersedia. Jika tidak, nama gaya datar, misalnya, "fabrikam", dikembalikan. Nama ini mungkin berbeda dari nama domain yang diminta jika domain telah diganti namanya.

DnsForestName

Penunjuk ke string yang dihentikan null yang menentukan nama domain di akar pohon DS. Nama gaya DNS, misalnya, "fabrikam.com", dikembalikan jika tersedia. Jika tidak, nama gaya datar, misalnya, "fabrikam" dikembalikan.

Flags

Berisi sekumpulan bendera yang menjelaskan pengendali domain. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

DS_DNS_CONTROLLER_FLAG

Anggota DomainControllerName dalam format DNS.

DS_DNS_DOMAIN_FLAG

Anggota DomainName dalam format DNS.

DS_DNS_FOREST_FLAG

Anggota DnsForestName dalam format DNS.

DS_CLOSEST_FLAG

Pengendali domain berada di situs yang sama dengan klien.

DS_DS_FLAG

Pengendali domain adalah server layanan direktori untuk domain.

DS_FULL_SECRET_DOMAIN_6_FLAG

Pengendali domain adalah pengontrol domain bisa-tulis Windows 2008 atau yang lebih baru.

DS_GOOD_TIMESERV_FLAG

Pengendali domain menjalankan Layanan Waktu Windows yang andal untuk domain.

DS_GC_FLAG

Pengendali domain adalah server katalog global untuk forest yang ditentukan oleh DnsForestName.

DS_KDC_FLAG

Pengendali domain adalah Pusat Distribusi Kunci Kerberos untuk domain.

DS_LDAP_FLAG

Server adalah server LDAP.

DS_NDNC_FLAG

Nama Domain adalah konteks penamaan aplikasi (non-domain).

DS_PDC_FLAG

Pengendali domain adalah pengendali domain utama domain.

DS_SELECT_SECRET_DOMAIN_6_FLAG

Pengendali domain adalah pengontrol domain baca-saja Windows 2008 atau yang lebih baru.

DS_TIMESERV_FLAG

Pengendali domain menjalankan Layanan Waktu Windows untuk domain.

DS_WRITABLE_FLAG

Pengendali domain menghosting layanan direktori bisa-tulis (atau SAM).

DcSiteName

Penunjuk ke string yang dihentikan null yang menentukan nama situs tempat pengontrol domain berada. Anggota ini mungkin null jika pengendali domain tidak ada di situs; misalnya, pengendali domain adalah pengontrol domain Windows NT 4.0.

ClientSiteName

Penunjuk ke string yang dihentikan null yang menentukan nama situs tempat komputer berada. Komputer ditentukan dalam parameter ComputerName yang diteruskan ke DsGetDcName. Anggota ini mungkin null jika situs yang berisi komputer tidak dapat ditemukan; misalnya, jika administrator DS belum mengaitkan subnet tempat komputer berada dengan situs yang valid.

Komentar

Nota

Header dsgetdc.h mendefinisikan DOMAIN_CONTROLLER_INFO 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
Header	dsgetdc.h

Lihat juga

Struktur Layanan Direktori

DsGetDcName

Bagikan melalui