Share via


AddSecureMemoryCacheCallback 函式 (winbase.h)

註冊在釋放安全記憶體範圍或其保護變更時要呼叫的回呼函式。

語法

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

參數

[in] pfnCallBack

要註冊之應用程式定義 SecureMemoryCacheCallback 函式的指標。

傳回值

如果函式成功,它會註冊回呼函式並傳回 TRUE

如果函式失敗,則會傳回 FALSE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError 函 式。

備註

直接對高效能裝置執行 I/O 的應用程式通常會快取用於 I/O 之緩衝區的虛擬到實體記憶體對應。 裝置的驅動程式通常會藉由呼叫 MmSecureVirtualMemory 例程來保護此記憶體位址範圍,以防止釋放記憶體範圍或其保護變更,直到驅動程式不安全記憶體為止。

應用程式可以使用 AddSecureMemoryCacheCallback 來註冊回呼函式,該函式會在釋放記憶體或變更其保護時呼叫,讓應用程式失效其快取的記憶體對應。 如需詳細資訊,請參閱 SecureMemoryCacheCallback

若要編譯使用此函式的應用程式,請將 _WIN32_WINNT 定義為0x0600或更新版本。 如需詳細資訊,請參閱 使用 Windows 標頭

規格需求

需求
最低支援的用戶端 Windows Vista SP1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback