Поделиться через

функция Msv1_0SubAuthenticationRoutineEx (subauth.h)

  • Статья

Выполняет проверку подлинности службы удаленного доступа при запросе вложенной проверки подлинности путем вызова функции LogonUser .

Учетные данные субъекта безопасности и сведения из базы данных диспетчера учетных записей безопасности (SAM) передаются этой функции для проверки подлинности.

Эта функция реализуется пользовательскими библиотеками DLL пакета под аутентификации для использования с пакетом проверки подлинности MSV1_0.

Эта функция вызывается только для неинтерактивной проверки подлинности, только на сервере проверки подлинности, на котором находится учетная запись, и только в том случае, если вложенная библиотека DLL-библиотека проверки подлинности зарегистрирована с правильным разделом в реестре.

Синтаксис

NTSTATUS Msv1_0SubAuthenticationRoutineEx(
  [in]      NETLOGON_LOGON_INFO_CLASS LogonLevel,
  [in]      PVOID                     LogonInformation,
  [in]      ULONG                     Flags,
  [in]      PUSER_ALL_INFORMATION     UserAll,
  [in]      SAM_HANDLE                UserHandle,
  [in, out] PMSV1_0_VALIDATION_INFO   ValidationInfo,
  [out]     PULONG                    ActionsPerformed
);

Параметры

[in] LogonLevel

Указывает уровень сведений, указанных в параметре LogonInformation . Этот параметр обычно имеет значение NetlogonInteractiveInformation.

[in] LogonInformation

Указатель на структуру NETLOGON_LOGON_IDENTITY_INFO . Элементы этой структуры содержат сведения о пользователе, который входит в систему. Элемент LogonDomainName этой структуры игнорируется.

[in] Flags

Необязательный элемент. Содержит флаги, описывающие обстоятельства входа. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
MSV1_0_PASSTHRU
 Сквозная проверка подлинности. Пользователь не подключается к этому компьютеру.
MSV1_0_GUEST_LOGON
 Это повторная попытка входа с помощью учетной записи пользователя GUEST.

[in] UserAll

Указатель на структуру USER_ALL_INFORMATION , содержащую описание пользователя, возвращенное из базы данных SAM.

[in] UserHandle

Дескриптор учетной записи пользователя.

[in, out] ValidationInfo

Указатель на структуру MSV1_0_VALIDATION_INFO.

[out] ActionsPerformed

Список выполненных действий.

Возвращаемое значение

Эта функция должна возвращать одно из следующих значений.

Код возврата Описание
STATUS_SUCCESS
 Ошибки не было.
STATUS_ACCOUNT_DISABLED
 Учетная запись отключена.
STATUS_ACCOUNT_EXPIRED
 Срок действия учетной записи истек.
STATUS_ACCOUNT_LOCKED_OUT
 Учетная запись заблокирована.
STATUS_INVALID_INFO_CLASS
 LogonLevel недопустим.
STATUS_INVALID_WORKSTATION
 Пользователь не имеет прав на вход на указанную рабочую станцию.
STATUS_NO_SUCH_USER
 У указанного пользователя нет учетной записи.
STATUS_PASSWORD_EXPIRED
 Срок действия пароля истек.
STATUS_PASSWORD_MUST_CHANGE
 Учетная запись помечена, чтобы указать, что пароль необходимо изменить при следующем входе.
STATUS_WRONG_PASSWORD
 Недопустимый пароль.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header subauth.h