AddSecureMemoryCacheCallback-Funktion (winbase.h)

Registriert eine Rückruffunktion, die aufgerufen werden soll, wenn ein geschützter Speicherbereich freigegeben oder sein Schutz geändert wird.

Syntax

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

Parameter

[in] pfnCallBack

Ein Zeiger auf die anwendungsdefinierte SecureMemoryCacheCallback-Funktion , die registriert werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, registriert sie die Rückruffunktion und gibt TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

Hinweise

Eine Anwendung, die E/A direkt auf einem hochleistungsfähigem Gerät ausführt, zwischenspeichert in der Regel eine Virtual-to-Physical-Speicherzuordnung für den Puffer, den sie für die E/A verwendet. Der Treiber des Geräts sichert diesen Speicheradressbereich in der Regel durch Aufrufen der MmSecureVirtualMemory-Routine , die verhindert, dass der Speicherbereich freigegeben wird oder der Schutz geändert wird, bis der Treiber den Arbeitsspeicher auflöst.

Eine Anwendung kann AddSecureMemoryCacheCallback verwenden, um eine Rückruffunktion zu registrieren, die aufgerufen wird, wenn der Arbeitsspeicher freigegeben oder der Schutz geändert wird, sodass die Anwendung ihre zwischengespeicherte Speicherzuordnung ungültig machen kann. Weitere Informationen finden Sie unter SecureMemoryCacheCallback.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback