функция обратного вызова LSA_GET_AUTH_DATA_FOR_USER (ntsecpkg.h)

  • Статья

Функция GetAuthDataForUser извлекает сведения о проверке подлинности пользователя из базы данных диспетчера учетных записей безопасности (SAM) и помещает их в формат, подходящий для функции ConvertAuthDataToToken .

Синтаксис

LSA_GET_AUTH_DATA_FOR_USER LsaGetAuthDataForUser;

NTSTATUS LsaGetAuthDataForUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [out] PUCHAR *UserAuthData,
  [out] PULONG UserAuthDataSize,
  [out] PUNICODE_STRING UserFlatName
)
{...}

Параметры

[in] Name

Указатель на структуру UNICODE_STRING , указывающую имя учетной записи SAM.

[in] NameType

Значение перечисления SECPKG_NAME_TYPE , указывающее тип имени учетной записи в поле Имя. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
SecNameSamCompatible
 Имя совместимо с SAM. Пример имени в формате, совместимом с SAM, — ExampleDomain\Username.
SecNameAlternateId
 Имя находится в свойстве AltSecId учетной записи SAM. При использовании этого значения необходимо указать значение параметра Prefix .
SecNameFlat
 Имя — это имя учетной записи в стиле имени участника-пользователя (UPN).
SecNameDN
 Name — это различающееся имя объекта. Дополнительные сведения см. в подразделе "Примечания".

[in] Prefix

Указатель на структуру UNICODE_STRING , содержащую префикс, используемый для имен, указанных с именем SecNameAlternateIdNameType.

[out] UserAuthData

Указатель, получающий адрес полученных данных.

[out] UserAuthDataSize

Указатель на ULONG , получающий размер полученных данных.

[out] UserFlatName

Указатель на структуру UNICODE_STRING , которая получает имя участника-пользователя, если применимо.

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

Если функция выполняется успешно, возвращаемое значение будет STATUS_SUCCESS.

Если функция завершается сбоем, возвращаемым значением является код NTSTATUS, указывающий причину сбоя.

Комментарии

Функция GetAuthDataForUser объединяет функции OpenSamUser, GetUserAuthData и CloseSamUser в один вызов.

Указатели на эти функции доступны в структуре LSA_SECPKG_FUNCTION_TABLE , полученной функцией SpInitialize .

Требования

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

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

CloseSamUser

GetUserAuthData

LSA_SECPKG_FUNCTION_TABLE

OpenSamUser

SpInitialize