Fungsi NetGetJoinInformation (lmjoin.h)

Artikel
03/14/2023

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

Bagikan melalui