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

此參數可以是下列值的位 OR 組合。

值 意義
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： 安全性內容會匯出至核心。只有在安全通道核心模式中才支援此值。

[out] pPackedContext

接收串行化安全性內容之類型SECBUFFER_EMPTY緩衝區的指標。 當您完成使用此內容時，請呼叫 FreeContextBuffer 函 式來釋放它。

[out, optional] pToken

接收內容令牌句柄的指標。

當您完成使用使用者令牌時，請呼叫 CloseHandle 函式來釋放句柄。

傳回值

如果函式成功，函式會傳回SEC_E_OK。

如果函式失敗，它會傳回下列其中一個錯誤碼。

傳回碼 Description
SEC_E_INSUFFICIENT_MEMORY
 記憶體不足，無法完成要求的動作。
SEC_E_INVALID_HANDLE
 phContext 參數不會指向有效的句柄。
SEC_E_NOT_SUPPORTED
 安全通道核心模式不支援此函式。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 sspi.h (包含 Security.h)
程式庫 Secur32.lib
Dll Secur32.dll

另請參閱

FreeContextBuffer

ImportSecurityContext

SSPI 函式