Fungsi NetGetJoinableOUs (lmjoin.h)

  • Artikel

Fungsi NetGetJoinableOUs mengambil daftar unit organisasi (OU) tempat akun komputer dapat dibuat.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetGetJoinableOUs(
  [in]  LPCWSTR lpServer,
  [in]  LPCWSTR lpDomain,
  [in]  LPCWSTR lpAccount,
  [in]  LPCWSTR lpPassword,
  [out] DWORD   *OUCount,
  [out] LPWSTR  **OUs
);

Parameter

[in] lpServer

Arahkan ke string konstanta yang menentukan nama DNS atau NetBIOS komputer untuk memanggil fungsi. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] lpDomain

Arahkan ke string konstanta yang menentukan nama domain untuk mengambil daftar OU yang dapat digabungkan.

[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.

[out] OUCount

Menerima jumlah OU yang dikembalikan dalam daftar OU yang dapat digabungkan.

[out] OUs

Penunjuk ke array yang menerima daftar OU yang dapat digabungkan. Array ini dialokasikan oleh sistem dan harus dikosongkan menggunakan satu panggilan ke fungsi NetApiBufferFree . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan 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_NOT_ENOUGH_MEMORY
 Penyimpanan tidak cukup tersedia untuk memproses perintah ini.
NERR_DefaultJoinRequired
 Pengontrol domain tujuan tidak mendukung pembuatan akun komputer di OU.

Keterangan

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

Untuk informasi selengkapnya tentang unit organisasi, lihat Mengelola Pengguna dalam dokumentasi Direktori Aktif.

Persyaratan

   
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

NetGetJoinInformation

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan