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

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

Синтаксис

SpAddCredentialsFn Spaddcredentialsfn;

NTSTATUS Spaddcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  PUNICODE_STRING PrincipalName,
  [in]  PUNICODE_STRING Package,
  [in]  ULONG CredentialUseFlags,
  [in]  PVOID AuthorizationData,
        PVOID GetKeyFunciton,
  [in]  PVOID GetKeyArgument,
  [out] PTimeStamp ExpirationTime
)
{...}

Параметры

[in] CredentialHandle

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

[in] PrincipalName

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

[in] Package

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

[in] CredentialUseFlags

Флаги, указывающие, как будут использоваться учетные данные. Допустимы следующие значения.

Значение Значение
SECPKG_CRED_INBOUND
Учетные данные будут использоваться с функцией AcceptSecurityContext (General).
SECPKG_CRED_OUTBOUND
Учетные данные будут использоваться с функцией InitializeSecurityContext (General).

[in] AuthorizationData

Необязательный элемент. Указатель на дополнительные данные проверки подлинности.

GetKeyFunciton

[in] GetKeyArgument

Указатель на аргумент, используемый с функцией GetKeyFunction .

[out] ExpirationTime

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

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

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

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

Комментарии

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

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

Требования

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

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

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize