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
标头 sspi.h (包括 Security.h)
Library Secur32.lib
DLL Secur32.dll

另请参阅

FreeContextBuffer

ImportSecurityContext

SSPI 函数