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。

如果指定的租户 ID 为 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 错误代码。