Fungsi ApplyControlToken (sspi.h)

Artikel
03/04/2024

Fungsi ApplyControlToken menyediakan cara untuk menerapkan token kontrol ke konteks keamanan. Token dapat diterima ketika konteks keamanan sedang dibuat oleh panggilan ke fungsi InitializeSecurityContext (Schannel) atau dengan layanan keamanan per pesan, seperti verifikasi atau tidak segel.

Fungsi ini hanya didukung oleh penyedia dukungan keamanan (SSP) Schannel.

Fungsi ini tidak didukung dalam mode kernel.

Fungsi ini memungkinkan token tambahan atau penggantian diterapkan ke konteks.

Sintaks

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pInput
);

Parameter

[in] phContext

Handel ke konteks tempat token diterapkan.

Untuk informasi tentang cara Schannel SSP memberi tahu pihak jarak jauh tentang penonaktifan, lihat bagian Keterangan decryptMessage (Schannel). Untuk informasi tambahan tentang penggunaan fungsi ini, lihat Mematikan Koneksi Schannel.

[in] pInput

Penunjuk ke struktur SecBufferDesc yang berisi penunjuk ke struktur SecBuffer yang berisi token input untuk diterapkan ke konteks.

Mengembalikan 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 yang dapat dikembalikan.

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

Keterangan

Fungsi ApplyControlToken dapat memodifikasi konteks berdasarkan token ini. Di antara token yang dapat ditambahkan fungsi ini ke konteks klien adalah SCHANNEL_ALERT_TOKEN dan SCHANNEL_SESSION_TOKEN.

Fungsi ini dapat digunakan untuk mematikan konteks keamanan yang mendasar koneksi Schannel yang ada. Untuk informasi tentang cara melakukannya, lihat Mematikan Koneksi Schannel.

Persyaratan

Persyaratan	Nilai
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