Fungsi panggilan balik SpSealMessageFn (ntsecpkg.h)
Mengenkripsi pesan yang dipertukarkan antara klien dan server.
Fungsi SpSealMessage adalah fungsi pengiriman untuk fungsi EncryptMessage (Umum) dari Antarmuka Penyedia Dukungan Keamanan.
Sintaks
SpSealMessageFn Spsealmessagefn;
NTSTATUS Spsealmessagefn(
[in] LSA_SEC_HANDLE ContextHandle,
[in] ULONG QualityOfProtection,
[in, out] PSecBufferDesc MessageBuffers,
[in] ULONG MessageSequenceNumber
)
{...}
Parameter
[in] ContextHandle
Menangani konteks keamanan yang digunakan untuk menandatangani pesan.
[in] QualityOfProtection
Menentukan bendera khusus paket yang menunjukkan kualitas perlindungan. SSP/AP dapat menggunakan parameter ini untuk mengaktifkan pemilihan algoritma kriptografi.
[in, out] MessageBuffers
Penunjuk ke struktur SecBufferDesc yang berisi buffer pesan. Hanya salah satu buffer pesan ini yang dapat berjenis SECBUFFER_DATA, dan berisi pesan yang akan dienkripsi. Buffer tidak dapat memiliki atribut SECBUFFER_READONLY karena enkripsi dilakukan di tempat.
[in] MessageSequenceNumber
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. Tabel berikut mencantumkan alasan umum kegagalan dan kode kesalahan yang harus dikembalikan fungsi.
Menampilkan kode | Deskripsi |
---|---|
|
Konteks tidak dapat ditemukan atau tidak dikonfigurasi untuk integritas pesan. |
|
Buffer tanda tangan tidak dapat ditemukan atau terlalu kecil. |
Keterangan
Pesan yang dienkripsi oleh pengirim menggunakan fungsi SpSealMessage didekripsi menggunakan fungsi SpUnsealMessage .
SSP/APs harus menerapkan fungsi SpSealMessage ; namun, nama aktual yang diberikan untuk implementasi terserah pengembang.
Penunjuk ke fungsi SpSealMessage 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk