Функция ImportSecurityContextA (sspi.h)

Статья
11/20/2024

Функция ImportSecurityContext импортируетконтекст безопасности . Контекст безопасности должен быть экспортирован в процесс вызова ImportSecurityContext предыдущим вызовом ExportSecurityContext.

Синтаксис

SECURITY_STATUS SEC_ENTRY ImportSecurityContextA(
  [in]           LPSTR       pszPackage,
  [in]           PSecBuffer  pPackedContext,
  [in, optional] VOID        *Token,
  [out]          PCtxtHandle phContext
);

Параметры

[in] pszPackage

Строка, содержащая имя пакета безопасности , в которую экспортирован контекст безопасности .

[in] pPackedContext

Указатель на буфер, содержащий сериализованный контекст безопасности, созданный ExportSecurityContext.

[in, optional] Token

Дескриптор маркера контекста.

[out] phContext

Дескриптор нового контекста безопасности, созданного из pPackedContext. Завершив использование контекста, удалите его, вызвав функцию DeleteSecurityContext.

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

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

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

Возвращаемый код	Описание
SEC_E_UNKNOWN_CREDENTIALS	Учетные данные, предоставленные пакету, не распознаны.
SEC_E_NO_CREDENTIALS	Учетные данные недоступны впакета безопасности .
SEC_E_NOT_OWNER	Вызывающий объект функции не имеет необходимых учетных данных.
SEC_E_INSUFFICIENT_MEMORY	Для выполнения запрошенного действия недостаточно памяти.
SEC_E_INTERNAL_ERROR	Произошла ошибка, которая не сопоставлялась с кодом ошибки SSPI.

Замечания

Заметка

Заголовок sspi.h определяет ImportSecurityContext как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	sspi.h (include Security.h)
библиотеки	Secur32.lib
DLL	Secur32.dll

См. также

ExportSecurityContext

FreeContextBuffer

функций SSPI

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