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

  • Статья

Функция 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 [только классические приложения]
Целевая платформа Windows
Header sspi.h (включая Security.h)
Библиотека Secur32.lib
DLL Secur32.dll

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

ExportSecurityContext

FreeContextBuffer

Функции SSPI