Fungsi panggilan balik PFNCryptStreamOutputCallback (ncryptprotect.h)

Fungsi PFNCryptStreamOutputCallback menerima data terenkripsi atau didekripsi dari tugas yang dimulai dengan menggunakan fungsi NCryptStreamOpenToProtect atau NCryptStreamOpenToUnprotect . Panggilan balik ini harus ditentukan oleh aplikasi Anda menggunakan sintaks berikut.

Sintaks

PFNCryptStreamOutputCallback Pfncryptstreamoutputcallback;

SECURITY_STATUS Pfncryptstreamoutputcallback(
  [in] void *pvCallbackCtxt,
  [in] const BYTE *pbData,
       SIZE_T cbData,
       BOOL fFinal
)
{...}

Parameter

[in] pvCallbackCtxt

Arahkan ke data yang dapat Anda gunakan untuk melacak aplikasi Anda. Data tidak dimodifikasi oleh API perlindungan data.

Catatan Anda dapat mengatur penunjuk ke data konteks Anda di anggota pvCallbackCtxt dari struktur NCRYPT_PROTECT_STREAM_INFO sebelum meneruskan penunjuk ke struktur tersebut dalam parameter pStreamInfo dari fungsi NCryptStreamOpenToProtect atau NCryptStreamOpenToUnprotect .

 

[in] pbData

Penunjuk ke blok data yang diproses yang dapat digunakan oleh aplikasi.

cbData

Ukuran, dalam byte, dari data yang diproses menunjuk ke oleh parameter pbData .

fFinal

Jika nilai ini TRUE, blok data saat ini adalah yang terakhir diproses dan ini adalah terakhir kali panggilan balik akan dipanggil.

Nilai kembali

Jika Anda mengembalikan kode status selain ERROR_SUCCESS dari implementasi fungsi panggilan balik ini, enkripsi aliran atau proses dekripsi akan gagal.

Menampilkan kode	Deskripsi
ERROR_SUCCESS	Fungsi berhasil.

Keterangan

Atur pointer ke fungsi panggilan balik ini di anggota pfnStreamOutput dari struktur NCRYPT_PROTECT_STREAM_INFO . Atur pointer ke struktur dalam parameter pStreamInfo dari fungsi NCryptStreamOpenToProtect atau NCryptStreamOpenToUnprotect .

Anda dapat menggunakan panggilan balik ini untuk memproses data terenkripsi atau didekripsi lebih lanjut. Penggunaan umum fungsi ini adalah menulis data ke disk seperti yang diterima dari API perlindungan data. Blok data terenkripsi atau tidak terenkripsi dibuat oleh fungsi NCryptStreamUpdate .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	ncryptprotect.h

Lihat juga

Fungsi CNG DPAPI

NCRYPT_PROTECT_STREAM_INFO

NCryptStreamOpenToProtect

NCryptStreamOpenToUnprotect

NCryptStreamUpdate