Fungsi NetGetAnyDCName (lmaccess.h)

Fungsi NetGetAnyDCName mengembalikan nama pengendali domain (DC) apa pun untuk domain yang secara langsung dipercaya oleh server yang ditentukan.

Aplikasi yang mendukung nama gaya DNS harus memanggil fungsi DsGetDcName . Fungsi ini dapat menemukan DC apa pun di domain apa pun, baik domain secara langsung dipercaya oleh server yang ditentukan atau tidak.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
        LPCWSTR ServerName,
        LPCWSTR DomainName,
        LPBYTE  *Buffer
);

Parameter

ServerName

Penunjuk ke string konstanta yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi akan dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

DomainName

Penunjuk ke string konstanta yang menentukan nama domain. Jika parameter ini ADALAH NULL, nama pengendali domain untuk domain utama digunakan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Buffer

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

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

Menampilkan kode	Deskripsi
ERROR_NO_LOGON_SERVERS	Tidak ada pengendali domain yang dapat ditemukan.
ERROR_NO_SUCH_DOMAIN	Domain yang ditentukan bukan domain tepercaya.
ERROR_NO_TRUST_LSA_SECRET	Sisi klien dari hubungan kepercayaan rusak.
ERROR_NO_TRUST_SAM_ACCOUNT	Sisi server hubungan kepercayaan rusak atau kata sandi rusak.
ERROR_DOMAIN_TRUST_INCONSISTENT	Server yang merespons bukanlah pengendali domain yang tepat dari domain yang ditentukan.

Keterangan

Tidak ada keanggotaan grup khusus yang diperlukan untuk berhasil menjalankan fungsi NetGetAnyDCName .

Jika nama server menentukan stasiun kerja yang berdiri sendiri atau server yang berdiri sendiri, tidak ada nama domain yang valid.

Jika nama server menentukan stasiun kerja yang merupakan anggota domain, atau server yang merupakan anggota domain, nama domain harus berada di domain yang sama dengan nama server.

Jika servername menentukan pengendali domain, nama domain harus menjadi salah satu domain yang dipercaya oleh domain yang servernya adalah pengontrol. Pengendali domain yang ditemukan panggilan ini telah beroperasi setidaknya sekali selama panggilan ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	lmaccess.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

DsGetDcName

Dapatkan Fungsi

NetGetDCName

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan