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

Функция 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