Fungsi AddSecureMemoryCacheCallback (winbase.h)

  • Artikel

Mendaftarkan fungsi panggilan balik yang akan dipanggil ketika rentang memori aman dibebaskan atau perlindungannya diubah.

Sintaks

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

Parameter

[in] pfnCallBack

Penunjuk ke fungsi SecureMemoryCacheCallback yang ditentukan aplikasi untuk mendaftar.

Nilai kembali

Jika fungsi berhasil, fungsi akan mendaftarkan fungsi panggilan balik dan mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Keterangan

Aplikasi yang melakukan I/O langsung ke perangkat berkinerja tinggi biasanya menyimpan cache pemetaan memori virtual-ke-fisik untuk buffer yang digunakannya untuk I/O. Driver perangkat biasanya mengamankan rentang alamat memori ini dengan memanggil rutinitas MmSecureVirtualMemory , yang mencegah rentang memori dibebaskan atau perlindungannya berubah sampai driver tidak aman memori.

Aplikasi dapat menggunakan AddSecureMemoryCacheCallback untuk mendaftarkan fungsi panggilan balik yang akan dipanggil ketika memori dibebaskan atau perlindungannya diubah, sehingga aplikasi dapat membatalkan pemetaan memori yang di-cache. Untuk informasi selengkapnya, lihat SecureMemoryCacheCallback.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header winbase.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback