I_NetLogonControl2 (lmaccess.h)

Artikel
03/09/2023

Fungsi I_NetLogonControl2 mengontrol berbagai aspek layanan Netlogon.

Sintaks

NET_API_STATUS NET_API_FUNCTION I_NetLogonControl2(
  [in, optional] LPCWSTR ServerName,
  [in]           DWORD   FunctionCode,
  [in]           DWORD   QueryLevel,
  [in]           LPBYTE  Data,
  [out]          LPBYTE  *Buffer
);

Parameter

[in, optional] ServerName

Nama server jarak jauh.

[in] FunctionCode

Operasi yang akan dilakukan. Nilai ini bisa menjadi salah satu dari berikut ini.

Nilai	Makna
NETLOGON_CONTROL_QUERY 1	Tidak ada operasi. Hanya mengembalikan informasi yang diminta.
NETLOGON_CONTROL_REPLICATE 2	Memaksa database manajer akun keamanan (SAM) pada pengendali domain cadangan (BDC) untuk disinkronkan dengan salinan pada pengendali domain utama (PDC). Operasi ini tidak menyiratkan sinkronisasi penuh. Layanan Netlogon mereplikasi perbedaan yang luar biasa jika memungkinkan.
NETLOGON_CONTROL_SYNCHRONIZE 3	Memaksa BDC untuk mendapatkan salinan baru database SAM dari PDC. Operasi ini melakukan sinkronisasi penuh.
NETLOGON_CONTROL_PDC_REPLICATE 4	Memaksa PDC untuk meminta setiap BDC untuk mereplikasi sekarang.
NETLOGON_CONTROL_REDISCOVER 5	Memaksa pengendali domain (DC) untuk menemukan kembali DC domain tepercaya yang ditentukan.
NETLOGON_CONTROL_TC_QUERY 6	Mengkueri saluran aman, meminta pembaruan status tentang penggunaan terakhirnya.
NETLOGON_CONTROL_TC_VERIFY 10	Memverifikasi status saat ini dari saluran aman domain tepercaya yang ditentukan. Jika status menunjukkan keberhasilan, pengendali domain di-ping. Jika status atau ping menunjukkan kegagalan, pengendali domain tepercaya baru akan dipulihkan.
NETLOGON_CONTROL_CHANGE_PASSWORD 9	Memaksa perubahan kata sandi pada saluran aman ke domain tepercaya.
NETLOGON_CONTROL_FORCE_DNS_REG 11	Memaksa pengendali domain untuk mendaftarkan ulang semua catatan DNS-nya. Parameter QueryLevel harus diatur ke 1.
NETLOGON_CONTROL_QUERY_DNS_REG 12	Mengeluarkan kueri yang meminta status pembaruan DNS yang dilakukan oleh layanan Netlogon. Jika terjadi kesalahan pendaftaran DNS atau deregistrasi pada pembaruan terakhir, hasilnya negatif. Parameter QueryLevel harus diatur ke 1.

[in] QueryLevel

Menunjukkan informasi apa yang harus dikembalikan dari layanan Netlogon. Nilai ini bisa menjadi salah satu struktur berikut.

NETLOGON_INFO_1 (1)

NETLOGON_INFO_2 (2)

NETLOGON_INFO_3 (3)

NETLOGON_INFO_4 (4)

[in] Data

Membawa data input yang bergantung pada nilai yang ditentukan dalam parameter FunctionCode . Kode fungsi NETLOGON_CONTROL_REDISCOVER dan NETLOGON_CONTROL_TC_QUERY menentukan nama domain tepercaya (jenis datanya adalah LPWSTR *).

[out] Buffer

Mengembalikan penunjuk ke buffer yang berisi informasi yang diminta dalam struktur yang diteruskan dalam parameter QueryLevel .

Buffer harus dikosongkan menggunakan NetApiBufferFree.

Menampilkan nilai

Metode mengembalikan 0x00000000 (NERR_Success) pada keberhasilan; jika tidak, kode kesalahan bukan nol yang ditentukan dalam Lmerr.h atau Winerror.h. NET_API_STATUS kode kesalahan dimulai dengan nilai 0x00000834. Untuk informasi selengkapnya tentang kode kesalahan manajemen jaringan, lihat Network_Management_Error_Codes. Tabel berikut ini menjelaskan kemungkinan nilai yang dikembalikan.

Mengembalikan kode/nilai	Deskripsi
NERR_Success 0x00000000	Panggilan metode selesai tanpa kesalahan.
ERROR_ACCESS_DENIED 0x00000005	Validasi akses pada pemanggil mengembalikan false. Akses ditolak.
ERROR_NOT_ENOUGH_MEMORY 0x00000008	Penyimpanan tidak cukup tersedia untuk memproses perintah ini.
ERROR_NOT_SUPPORTED 0x00000032	Kode fungsi tidak valid pada server yang ditentukan. Misalnya, NETLOGON_CONTROL_REPLICATE mungkin telah diteruskan ke pengendali domain utama (PDC).
ERROR_INVALID_PARAMETER 0x00000057	Parameter salah.
ERROR_INVALID_LEVEL 0x0000007C	Tingkat panggilan kueri tidak benar.
ERROR_SERVICE_NOT_ACTIVE 0x000004261210121	Layanan belum dimulai.
ERROR_INVALID_COMPUTERNAME 0x000004BA	Format nama komputer yang ditentukan tidak valid.
ERROR_NO_LOGON_SERVERS 0x0000051F	Saat ini tidak ada server masuk yang tersedia untuk melayani permintaan masuk.
ERROR_INVALID_DOMAIN_ROLE 0x0000054A	Perubahan kata sandi untuk akun kepercayaan interdomain dicoba pada pengendali domain cadangan (BDC). Operasi ini hanya diperbolehkan untuk PDC domain.
ERROR_NO_SUCH_DOMAIN 0x0000054B	Domain yang ditentukan tidak ada atau tidak dapat dihubungi.
NERR_UserNotFound 0x000008AD	Nama pengguna tidak dapat ditemukan.

Keterangan

Fungsi ini dapat digunakan untuk meminta agar BDC memastikan bahwa salinan database SAM-nya diperbarui. Ini juga dapat digunakan untuk menentukan apakah BDC saat ini memiliki saluran aman yang terbuka untuk PDC.