Fungsi NetGetAadJoinInformation (lmjoin.h)

Mengambil informasi gabungan untuk penyewa yang ditentukan. Fungsi ini memeriksa informasi gabungan untuk Microsoft Azure Active Directory dan akun kerja yang ditambahkan pengguna saat ini.

Sintaks

HRESULT NET_API_FUNCTION NetGetAadJoinInformation(
  [in, optional] LPCWSTR          pcszTenantId,
  [out]          PDSREG_JOIN_INFO *ppJoinInfo
);

Parameter

[in, optional] pcszTenantId

Pengidentifikasi penyewa untuk akun yang bergabung. Jika perangkat tidak bergabung ke Azure Active Directory (Azure AD), dan pengguna yang saat ini masuk ke Windows tidak menambahkan akun kerja Azure AD untuk penyewa yang ditentukan, buffer yang ditunjuk parameter ppJoinInfo diatur ke NULL.

Jika ID penyewa yang ditentukan adalah NULL atau kosong, ppJoinInfo diatur ke informasi akun gabungan default, atau NULL jika perangkat tidak bergabung ke Azure AD dan pengguna saat ini tidak menambahkan akun kerja Azure AD.

Akun gabungan default adalah salah satu hal berikut ini:

• Akun Azure AD, jika perangkat bergabung ke Azure AD.
• Akun kerja Azure AD yang ditambahkan pengguna saat ini, jika perangkat tidak bergabung ke Azure AD, tetapi pengguna saat ini menambahkan satu akun kerja Azure AD.
• Salah satu akun kerja Azure AD yang ditambahkan pengguna saat ini, jika perangkat tidak bergabung ke Azure AD, tetapi pengguna saat ini menambahkan beberapa akun kerja Azure AD. Algoritma untuk memilih salah satu akun kerja tidak ditentukan.

[out] ppJoinInfo

Informasi gabungan untuk penyewa yang ditentukan parameter pcszTenantId . Jika parameter ini NULL, perangkat tidak bergabung ke Azure AD dan pengguna saat ini tidak menambahkan akun kerja Azure AD. Anda harus memanggil fungsi NetFreeAadJoinInformation untuk membebaskan memori yang dialokasikan untuk struktur ini.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	lmjoin.h
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

NetFreeAadJoinInformation