Fungsi NetGetJoinInformation (lmjoin.h)

  • Artikel

Fungsi NetGetJoinInformation mengambil informasi status gabungan untuk komputer yang ditentukan.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetGetJoinInformation(
  [in]  LPCWSTR               lpServer,
  [out] LPWSTR                *lpNameBuffer,
  [out] PNETSETUP_JOIN_STATUS BufferType
);

Parameter

[in] lpServer

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

[out] lpNameBuffer

Arahkan ke buffer yang menerima nama NetBIOS domain atau grup kerja tempat komputer bergabung. Buffer ini dialokasikan oleh sistem dan harus dibebaskan menggunakan fungsi NetApiBufferFree . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.

[out] BufferType

Menerima status gabungan komputer yang ditentukan. Parameter ini dapat memiliki salah satu nilai berikut.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

Nilai-nilai ini memiliki arti berikut.

Nilai Makna
NetSetupUnknownStatus
 Status tidak diketahui.
NetSetupUnjoined
 Komputer tidak bergabung.
NetSetupWorkgroupName
 Komputer tergabung ke grup kerja.
NetSetupDomainName
 Komputer bergabung ke domain.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

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

Menampilkan kode Deskripsi
ERROR_NOT_ENOUGH_MEMORY
 Penyimpanan tidak cukup tersedia untuk memproses perintah ini.

Keterangan

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

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; Wkscli.dll

Lihat juga

NetGetJoinableOUs

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan