Fungsi VerifySignature (sspi.h)

  • Artikel

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