NetGetAadJoinInformation 函式 (lmjoin.h)

擷取指定租用戶的聯結資訊。此函式會檢查 Microsoft Azure Active Directory的聯結資訊，以及目前使用者新增的工作帳戶。

語法

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

[in, optional] pcszTenantId

已加入帳戶的租用戶標識碼。如果裝置未加入 Azure Active Directory (Azure AD) ，且目前登入 Windows 的使用者未為指定的租使用者新增任何 Azure AD 工作帳戶， ppJoinInfo 參數所指向的緩衝區會設定為 NULL。

如果指定的租使用者標識碼為 NULL 或空白， ppJoinInfo 會設定為預設加入帳戶資訊，如果裝置未加入 Azure AD，且目前使用者未新增任何 Azure AD 工作帳戶，則為 NULL。

預設加入帳戶是下列其中一項：

如果裝置已加入 Azure AD，則為 Azure AD 帳戶。
如果裝置未加入 Azure AD，但目前使用者已新增單一 Azure AD 工作帳戶，則為目前使用者新增的 Azure AD 工作帳戶。
如果裝置未加入 Azure AD，但目前使用者已新增多個 Azure AD 工作帳戶，則為目前使用者新增的任何 Azure AD 工作帳戶。未指定選取其中一個工作帳戶的演算法。

[out] ppJoinInfo

pcszTenantId 參數所指定租用戶的聯結資訊。如果此參數為 NULL，則裝置未加入 Azure AD，且目前使用者未新增任何 Azure AD 工作帳戶。您必須呼叫 NetFreeAadJoinInformation 函式，以釋放配置給這個結構的記憶體。

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。