Fungsi VerifySignature (sspi.h)

Artikel
03/13/2024

Memverifikasi bahwa pesan yang ditandatangani dengan menggunakan fungsi MakeSignature diterima dalam urutan yang benar dan belum dimodifikasi.

Sintaks

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY VerifySignature(
  [in]  PCtxtHandle    phContext,
  [in]  PSecBufferDesc pMessage,
  [in]  unsigned long  MessageSeqNo,
  [out] unsigned long  *pfQOP
);

Parameter

[in] phContext

Handel ke konteks keamanan yang akan digunakan untuk pesan.

[in] pMessage

Arahkan ke struktur SecBufferDesc yang mereferensikan sekumpulan struktur SecBuffer yang berisi pesan dan tanda tangan untuk diverifikasi. Tanda tangan berada dalam struktur SecBuffer jenis SECBUFFER_TOKEN.

[in] MessageSeqNo

Menentukan nomor urut yang diharapkan oleh aplikasi transportasi, jika ada. Jika aplikasi transportasi tidak mempertahankan nomor urut, parameter ini adalah nol.

[out] pfQOP

Penunjuk ke variabel ULONG yang menerima bendera khusus paket yang menunjukkan kualitas perlindungan.

Beberapa paket keamanan mengabaikan parameter ini.

Mengembalikan nilai

Jika fungsi memverifikasi bahwa pesan diterima dalam urutan yang benar dan belum dimodifikasi, nilai yang dikembalikan SEC_E_OK.

Jika fungsi menentukan bahwa pesan tidak benar sesuai dengan informasi dalam tanda tangan, nilai yang dikembalikan dapat menjadi salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
SEC_E_OUT_OF_SEQUENCE	Pesan tidak diterima dalam urutan yang benar.
SEC_E_MESSAGE_ALTERED	Pesan telah diubah.
SEC_E_INVALID_HANDLE	Handel konteks yang ditentukan oleh phContext tidak valid.
SEC_E_INVALID_TOKEN	pMessage tidak berisi buffer SECBUFFER_TOKEN yang valid, atau berisi terlalu sedikit buffer.
SEC_E_QOP_NOT_SUPPORTED	Kualitas perlindungan yang dinegosiasikan antara klien dan server tidak termasuk pemeriksaan integritas .

Keterangan

Peringatan

Fungsi VerifySignature akan gagal jika pesan ditandatangani menggunakan algoritma RsaSignPssSha512 pada versi Windows yang berbeda. Misalnya, pesan yang ditandatangani dengan memanggil fungsi MakeSignature pada Windows 8 akan menyebabkan fungsi VerifySignature pada Windows 8.1 gagal.

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

MakeSignature

Fungsi SSPI

SecBuffer

Bagikan melalui