Fungsi NetUnjoinDomain (lmjoin.h)

Artikel
08/24/2023

Fungsi NetUnjoinDomain membatalkan bergabung dengan komputer dari grup kerja atau domain.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetUnjoinDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fUnjoinOptions
);

Parameter

[in] lpServer

Penunjuk ke string konstanta yang menentukan nama DNS atau NetBIOS komputer tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] lpAccount

Penunjuk ke string konstanta yang menentukan nama akun yang akan digunakan saat menyambungkan ke pengontrol domain. String harus menentukan nama domain NetBIOS dan akun pengguna (misalnya, REDMOND\user) atau nama prinsipal pengguna (UPN) pengguna dalam bentuk nama login gaya Internet (misalnya, "someone@example.com"). Jika parameter ini NULL, konteks pemanggil akan digunakan.

[in] lpPassword

Jika parameter lpAccount menentukan nama akun, parameter ini harus menunjuk ke kata sandi yang akan digunakan saat menyambungkan ke pengendali domain. Jika tidak, parameter ini harus NULL.

[in] fUnjoinOptions

Menentukan opsi batal bergabung. Jika parameter ini NETSETUP_ACCT_DELETE, akun dinonaktifkan saat unjoin terjadi. Perhatikan bahwa opsi ini tidak menghapus akun. Saat ini, tidak ada opsi lain yang tidak bergabung yang ditentukan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

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

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Parameter salah.
NERR_SetupNotJoined	Komputer saat ini tidak tergabung ke domain.
NERR_SetupDomainController	Komputer ini adalah pengendali domain dan tidak dapat dilepas dari domain.

Keterangan

Membatalkan bergabung (dan bergabung) komputer ke domain atau grup kerja hanya dapat dilakukan oleh anggota grup lokal Administrator pada komputer target. Jika Anda memanggil fungsi NetUnjoinDomain dari jarak jauh, Anda harus memberikan kredensial karena Anda tidak dapat mendelegasikan kredensial dalam keadaan ini.

Proses yang berbeda, atau utas yang berbeda dari proses yang sama, tidak boleh memanggil fungsi NetUnjoinDomain secara bersamaan. Situasi ini dapat membuat komputer dalam keadaan tidak konsisten.

Reboot sistem diperlukan setelah memanggil fungsi NetRenameMachineInDomain agar operasi selesai.

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	lmjoin.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

NetJoinDomain

NetRenameMachineInDomain

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan

Bagikan melalui