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) 。 這是呼叫 QueryCoNtextAttributes (Schannel) 函式傳回的值，當 傳遞SECPKG_ATTR_EAP_KEY_BLOCK 做為 ulAttribute 參數的值時。

只有安全通道安全性套件才支援這個屬性。
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。

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

傳回碼 Description
SEC_E_UNSUPPORTED_FUNCTION
 Schannel 核心模式會傳回這個值，表示不支援此函式。

備註

注意

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

規格需求

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