Share via

Функция 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 присваивается сведения об учетной записи присоединения по умолчанию или null, если устройство не присоединено к Azure AD и текущий пользователь не добавил Azure AD рабочих учетных записей.

По умолчанию используется одна из следующих учетных записей присоединения:

  • Учетная запись 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
Header lmjoin.h
Библиотека Netapi32.lib
DLL Netapi32.dll

См. также раздел

NetFreeAadJoinInformation