共用方式為

SetContextAttributesA 函式 （sspi.h）

  • 發行項

可讓傳輸應用程式為 安全性套件設定安全性 內容 屬性。 此函式僅受安全通道安全性套件支援。

語法

SECURITY_STATUS SEC_ENTRY SetContextAttributesA(
  [in] PCtxtHandle   phContext,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
  [in] unsigned long cbBuffer
);

參數

[in] phContext

要設定之安全性內容的句柄。

[in] ulAttribute

要設定之內容的屬性。 此參數可以是下列其中一個值。

價值 意義
SECPKG_ATTR_APP_DATA
94
 pBuffer 參數包含 SecPkgContext_SessionAppData 結構的指標。

設定工作階段的應用程式資料。

只有安全通道安全性套件才支援這個屬性。
SECPKG_ATTR_EAP_PRF_INFO
101
 pBuffer 參數包含 SecPkgContext_EapPrfInfo 結構的指標。

設定可延伸驗證通訊協定 （EAP） 所使用的虛擬隨機函式 （PRF）。 這是當 SECPKG_ATTR_EAP_KEY_BLOCK 傳遞為 ulAttribute 參數值時，呼叫 QueryContextAttributes （Schannel） 函式所傳回 的值。

只有安全通道安全性套件才支援這個屬性。
SECPKG_ATTR_EARLY_START
105
 pBuffer 參數包含 SecPkgContext_EarlyStart 結構的指標。

設定 False Start 功能。 如需這項功能的相關信息，請參閱 建置更快速且更安全的Web 部落格文章。
SECPKG_ATTR_DTLS_MTU
34
 設定並擷取 MTU （傳輸單位上限） 值，以搭配 DTLS 使用。 如果未在安全性內容中啟用 DTLS，則不支援此屬性。

有效值介於 200 個字節和 64 KB 之間。 Schannel 中的預設 DTLS MTU 值為 1096 個字節。
SECPKG_ATTR_KEYING_MATERIAL_INFO
106
 pBuffer 參數包含 SecPkgContext_KeyingMaterialInfo 結構的指標。 關鍵數據匯出功能遵循 RFC 5705 標準。

只有 Windows 10 和 Windows Server 2016 或更新版本的 Schannel 安全性套件才支援此屬性。

[in] pBuffer

結構的指標，其中包含要設定屬性的值。 指向的結構類型取決於 ulAttribute 參數中指定的值。

[in] cbBuffer

pBuffer 參數的大小，以位元組為單位。

傳回值

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

如果函式失敗，則會傳回非零的錯誤碼。 下列錯誤碼是其中一個可能的錯誤碼。

傳回碼 描述
SEC_E_UNSUPPORTED_FUNCTION
 這個值是由 Schannel 核心模式傳回，表示不支援此函式。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 sspi.h （include Security.h）
連結庫 Secur32.lib
DLL Secur32.dll