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

Статья
08/26/2023

Функция ExportSecurityContext создает сериализованное представление контекста безопасности , которое впоследствии можно импортировать в другой процесс путем вызова
ImportSecurityContext. Процесс, импортируемый контекст безопасности, должен выполняться на том же компьютере, что и процесс с именем ExportSecurityContext.

Синтаксис

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ExportSecurityContext(
  [in]            PCtxtHandle phContext,
  [in]            ULONG       fFlags,
  [out]           PSecBuffer  pPackedContext,
  [out, optional] void        **pToken
);

Параметры

[in] phContext

Дескриптор контекста безопасности для экспорта.

[in] fFlags

Этот параметр может быть побитовой или комбинацией следующих значений.

Значение	Значение
SECPKG_CONTEXT_EXPORT_RESET_NEW 1 (0x1)	Новый контекст безопасности сбрасывается в исходное состояние.
SECPKG_CONTEXT_EXPORT_DELETE_OLD 2 (0x2)	Старый контекст безопасности удаляется.
SECPKG_CONTEXT_EXPORT_TO_KERNEL 4 (0x4)	Это значение не поддерживается. Windows Server 2003 и Windows XP/2000: Контекст безопасности должен быть экспортирован в ядро. Это значение поддерживается только в режиме ядра Schannel.

[out] pPackedContext

Указатель на буфер типа SECBUFFER_EMPTY , который получает сериализованный контекст безопасности. Завершив использование этого контекста, освободите его, вызвав функцию FreeContextBuffer .

[out, optional] pToken

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

Завершив использование маркера пользователя, отпустите дескриптор, вызвав функцию CloseHandle .

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

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

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

Код возврата	Описание
SEC_E_INSUFFICIENT_MEMORY	Недостаточно памяти для выполнения запрошенного действия.
SEC_E_INVALID_HANDLE	Параметр phContext не указывает на допустимый дескриптор.
SEC_E_NOT_SUPPORTED	Режим ядра Schannel не поддерживает эту функцию.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	sspi.h (включая Security.h)
Библиотека	Secur32.lib
DLL	Secur32.dll

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

FreeContextBuffer

ImportSecurityContext

Функции SSPI

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