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 に参加していないが、現在のユーザーが 1 つの Azure AD 職場アカウントを追加した場合に、現在のユーザーが追加した Azure AD 職場アカウント。
- デバイスが Azure AD に参加していないが、現在のユーザーが複数の Azure AD 作業アカウントを追加した場合に、現在のユーザーが追加した Azure AD 作業アカウントのいずれか。 いずれかの職場アカウントを選択するためのアルゴリズムが指定されていません。
[out] ppJoinInfo
pcszTenantId パラメーターが指定するテナントの結合情報。 このパラメーターが NULL の場合、デバイスは Azure AD に参加せず、現在のユーザーは Azure AD の職場アカウントを追加していません。 この構造体に割り当てられたメモリを解放するには、 NetFreeAadJoinInformation 関数を呼び出す必要があります。
戻り値
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lmjoin.h |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |