Fungsi CompleteAuthToken (sspi.h)
Fungsi CompleteAuthToken menyelesaikan token autentikasi. Fungsi ini digunakan oleh protokol, seperti DCE, yang perlu merevisi informasi keamanan setelah aplikasi transportasi memperbarui beberapa parameter pesan.
Fungsi ini hanya didukung oleh penyedia dukungan keamanan (SSP) Digest.
CompleteAuthToken hanya digunakan di sisi server.
Sintaks
SECURITY_STATUS SEC_ENTRY CompleteAuthToken(
[in] PCtxtHandle phContext,
[in] PSecBufferDesc pToken
);
Parameter
[in] phContext
Handel konteks yang perlu diselesaikan.
[in] pToken
Penunjuk ke struktur SecBufferDesc yang berisi deskriptor buffer untuk seluruh pesan.
Mengembalikan nilai
Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.
Jika fungsi gagal, fungsi akan mengembalikan salah satu kode kesalahan berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Handel yang diteruskan ke fungsi tidak valid. |
|
Token yang diteruskan ke fungsi tidak valid. |
|
Konteks keamanan klien berada, tetapi nomor pesan salah. Nilai yang dikembalikan ini digunakan dengan Digest SSP. |
|
Konteks keamanan klien ditemukan, tetapi pesan klien telah diubah. Nilai yang dikembalikan ini digunakan dengan Digest SSP. |
|
Terjadi kesalahan yang tidak memetakan ke kode kesalahan SSPI. |
Keterangan
Klien aplikasi transportasi memanggil fungsi CompleteAuthToken untuk memungkinkan paket keamanan memperbarui checksum atau operasi serupa setelah semua header protokol telah diperbarui oleh aplikasi transportasi. Klien memanggil fungsi ini hanya jika panggilan InitializeSecurityContext (Digest) dikembalikan SEC_I_COMPLETE_NEEDED atau SEC_I_COMPLETE_AND_CONTINUE.
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 |