Fungsi panggilan balik KspMakeSignatureFn (ntsecpkg.h)

  • Artikel

Fungsi SpMakeSignature menghasilkan tanda tangan berdasarkan pesan dan konteks keamanan yang ditentukan.

Fungsi SpMakeSignature adalah fungsi pengiriman untuk fungsi MakeSignature dari Antarmuka Penyedia Dukungan Keamanan.

Sintaks

KspMakeSignatureFn Kspmakesignaturefn;

NTSTATUS Kspmakesignaturefn(
  [in] LSA_SEC_HANDLE ContextId,
  [in] ULONG fQOP,
  [in] PSecBufferDesc Message,
  [in] ULONG MessageSeqNo
)
{...}

Parameter

[in] ContextId

Handel ke konteks keamanan yang akan digunakan untuk menghasilkan tanda tangan pesan.

[in] fQOP

Menentukan bendera khusus paket yang menunjukkan kualitas perlindungan. Paket keamanan dapat menggunakan parameter ini untuk mendukung pemilihan algoritma kriptografi

[in] Message

Penunjuk ke struktur SecBuffer . Pada input, struktur berisi pesan yang akan ditandatangani.

[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.

Nilai kembali

Jika fungsi berhasil, kembalikan STATUS_SUCCESS.

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

Menampilkan kode Deskripsi
SEC_E_INVALID_HANDLE
 Handel tidak valid.

Keterangan

Mitra fungsi SpMakeSignature adalah fungsi SpVerifySignature , yang digunakan untuk memverifikasi tanda tangan di ujung penerima.

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

Penunjuk ke fungsi SpMakeSignature 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

SpUserModeInitialize

SpVerifySignature