Fungsi panggilan balik SpSealMessageFn (ntsecpkg.h)

  • Artikel

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
STATUS_INVALID_HANDLE
 Konteks tidak dapat ditemukan atau tidak dikonfigurasi untuk integritas pesan.
STATUS_INVALID_PARAMETER
 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

SECPKG_USER_FUNCTION_TABLE

SpUnsealMessage

SpUserModeInitialize