ImportSecurityContextA 函式 (sspi.h)

  • 發行項

ImportSecurityContext 函式會匯入安全性內容。 先前呼叫 ExportSecurityContext 時，安全性內容必須匯出至呼叫 ImportSecurityContext 的進程。

語法

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。

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

傳回碼 Description
SEC_E_UNKNOWN_CREDENTIALS
 無法辨識提供給封裝的認證。
SEC_E_NO_CREDENTIALS
 安全性套件中沒有可用的認證。
SEC_E_NOT_OWNER
 函式的呼叫端沒有必要的認證。
SEC_E_INSUFFICIENT_MEMORY
 記憶體不足，無法完成要求的動作。
SEC_E_INTERNAL_ERROR
 未對應至 SSPI 錯誤碼的錯誤。

備註

注意

sspi.h 標頭會將 ImportSecurityContext 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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

另請參閱

ExportSecurityContext

FreeContextBuffer

SSPI 函式