Fungsi SetContextAttributesA (sspi.h)

Artikel
08/26/2023

Memungkinkan aplikasi transportasi untuk mengatur atribut konteks keamanan untuk paket keamanan. Fungsi ini hanya didukung oleh paket keamanan Schannel.

Sintaks

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

Parameter

[in] phContext

Handel ke konteks keamanan yang akan diatur.

[in] ulAttribute

Atribut konteks yang akan ditetapkan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
SECPKG_ATTR_APP_DATA 94	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_SessionAppData . Mengatur data aplikasi untuk sesi. Atribut ini hanya didukung oleh paket keamanan Schannel.
SECPKG_ATTR_EAP_PRF_INFO 101	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_EapPrfInfo . Mengatur fungsi pseudo-random (PRF) yang digunakan oleh Extensible Authentication Protocol (EAP). Ini adalah nilai yang dikembalikan oleh panggilan ke fungsi QueryContextAttributes (Schannel) saat SECPKG_ATTR_EAP_KEY_BLOCK diteruskan sebagai nilai parameter ulAttribute . Atribut ini hanya didukung oleh paket keamanan Schannel.
SECPKG_ATTR_EARLY_START 105	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_EarlyStart . Mengatur fitur False Start. Lihat membuat posting blog web yang lebih cepat dan lebih aman untuk informasi tentang fitur ini.
SECPKG_ATTR_DTLS_MTU 34	Mengatur dan mengambil nilai MTU (unit transmisi maksimum) untuk digunakan dengan DTLS. Jika DTLS tidak diaktifkan dalam konteks keamanan, atribut ini tidak didukung. Nilai yang valid adalah antara 200 byte dan 64 kilobyte. Nilai DTLS MTU default di Schannel adalah 1096 byte.
SECPKG_ATTR_KEYING_MATERIAL_INFO 106	Parameter pBuffer berisi penunjuk ke struktur SecPkgContext_KeyingMaterialInfo . Fitur ekspor material keying mengikuti standar RFC 5705. Atribut ini hanya didukung oleh paket keamanan Schannel di Windows 10 dan Windows Server 2016 atau versi yang lebih baru.

[in] pBuffer

Penunjuk ke struktur yang berisi nilai untuk mengatur atribut. Jenis struktur yang menunjuk ke tergantung pada nilai yang ditentukan dalam parameter ulAttribute .

[in] cbBuffer

Ukuran, dalam byte, dari parameter pBuffer .

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan bukan nol. Kode kesalahan berikut adalah salah satu kemungkinan kode kesalahan.

Menampilkan kode	Deskripsi
SEC_E_UNSUPPORTED_FUNCTION	Nilai ini dikembalikan oleh mode kernel Schannel untuk menunjukkan bahwa fungsi ini tidak didukung.

Keterangan

Catatan

Header sspi.h mendefinisikan SetContextAttributes sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	sspi.h (termasuk Security.h)
Pustaka	Secur32.lib
DLL	Secur32.dll