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
SEC_E_INVALID_HANDLE	Handel yang diteruskan ke fungsi tidak valid.
SEC_E_INVALID_TOKEN	Token yang diteruskan ke fungsi tidak valid.
SEC_E_OUT_OF_SEQUENCE	Konteks keamanan klien berada, tetapi nomor pesan salah. Nilai yang dikembalikan ini digunakan dengan Digest SSP.
SEC_E_MESSAGE_ALTERED	Konteks keamanan klien ditemukan, tetapi pesan klien telah diubah. Nilai yang dikembalikan ini digunakan dengan Digest SSP.
SEC_E_INTERNAL_ERROR	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

Lihat juga

InitializeSecurityContext (Digest)

Fungsi SSPI

SecBufferDesc