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

  • Статья

Функция SpQueryCredentialsAttributes извлекает атрибуты для учетных данных.

Функция SpQueryCredentialsAttributes — это функция диспетчеризации для функции QueryCredentialsAttributesинтерфейса поставщика поддержки безопасности.

Синтаксис

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

Параметры

[in] CredentialHandle

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

[in] CredentialAttribute

Атрибут для запроса. В следующей таблице приведены допустимые значения параметра.

Значение Значение
SECPKG_CRED_ATTR_NAMES
 Имя субъекта, связанного с учетными данными.
SECPKG_ATTR_SUPPORTED_ALGS
 Алгоритмы, поддерживаемые определенными учетными данными.
SECPKG_ATTR_CIPHER_STRENGTHS
 Минимальная и максимальная надежность шифра, используемая с учетными данными.
SECPKG_ATTR_SUPPORTED_PROTOCOLS
 Протоколы, поддерживаемые с определенными учетными данными.

[out] Buffer

Указатель на буфер, получающий запрошенные атрибуты. Выделите память для этого буфера с помощью функции AllocateClientBuffer , чтобы вызывающий объект мог освободить ее, вызвав функцию FreeContextBuffer .

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

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

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

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

Комментарии

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

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

Требования

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

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

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize