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

  • Статья

Функция SpGetCredentials извлекает основные и дополнительные учетные данные из объекта пользователя.

Синтаксис

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

Параметры

[in] CredentialHandle

Дескриптор извлекаемых учетных данных.

[out] Credentials

Указатель на структуру SecBuffer , которая получает учетные данные.

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

Если функция выполнена успешно, верните STATUS_SUCCESS.

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

Код возврата Описание
SEC_E_INSUFFICIENT_MEMORY
 Недостаточно памяти для получения учетных данных.
SEC_E_INVALID_HANDLE
 Недопустимый дескриптор.

Комментарии

Поставщики общих служб и поставщики параметров доступа должны реализовывать функцию SpGetCredentials ; однако фактическое имя, присваиваемого реализации, задается разработчиком.

Указатель на функцию SpGetCredentials доступен в структуре SECPKG_FUNCTION_TABLE , полученной от функции SpLsaModeInitialize .

Требования

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

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

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize