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이거나 비어 있으면 디바이스가 Azure AD 조인되지 않고 현재 사용자가 Azure AD 회사 계정을 추가하지 않은 경우 ppJoinInfo가 기본 조인 계정 정보로 설정되거나 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 오류 코드를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | lmjoin.h |
| 라이브러리 | Netapi32.lib |
| DLL | Netapi32.dll |