Fungsi panggilan balik KspVerifySignatureFn (ntsecpkg.h)

  • Artikel

Memverifikasi bahwa pesan yang diterima sudah benar sesuai dengan tanda tangan.

Fungsi SpVerifySignature adalah fungsi pengiriman untuk fungsi VerifySignature dari Antarmuka Penyedia Dukungan Keamanan.

Sintaks

KspVerifySignatureFn Kspverifysignaturefn;

NTSTATUS Kspverifysignaturefn(
        LSA_SEC_HANDLE ContextId,
  [in]  PSecBufferDesc Message,
  [in]  ULONG MessageSeqNo,
  [out] PULONG pfQOP
)
{...}

Parameter

ContextId

[in] Message

Penunjuk ke struktur SecBufferDesc yang berisi pesan untuk diverifikasi.

[in] MessageSeqNo

Nomor urut untuk ditetapkan ke pesan. Nomor urut bersifat opsional dan digunakan sebagai perlindungan terhadap kehilangan dan penyisipan pesan. Nilai nol menunjukkan bahwa angka urutan tidak digunakan.

[out] pfQOP

Penunjuk ke bendera khusus paket yang menunjukkan kualitas perlindungan.

Nilai kembali

Jika fungsi berhasil, kembalikan STATUS_SUCCESS.

Jika fungsi gagal, kembalikan kode NTSTATUS yang menunjukkan alasan gagalnya. Tabel berikut mencantumkan alasan umum kegagalan dan kode kesalahan yang harus dikembalikan fungsi.

Menampilkan kode Deskripsi
SEC_E_INVALID_HANDLE
 Handel tidak valid.

Keterangan

Tanda tangan yang diverifikasi oleh fungsi SpVerifySignature dibuat oleh fungsi SpMakeSignature , yang digunakan oleh pengirim pesan.

SSP/APs harus mengimplementasikan fungsi SpVerifySignature ; namun, nama aktual yang diberikan untuk implementasi terserah pengembang.

Penunjuk ke fungsi SpVerifySignature tersedia dalam struktur SECPKG_USER_FUNCTION_TABLE yang diterima dari fungsi SpUserModeInitialize .

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 ntsecpkg.h

Lihat juga

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpMakeSignature

SpUserModeInitialize

VerifySignature