AddSecureMemoryCacheCallback, fonction (winbase.h)

Inscrit une fonction de rappel à appeler lorsqu’une plage de mémoire sécurisée est libérée ou que ses protections sont modifiées.

Syntaxe

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

Paramètres

[in] pfnCallBack

Pointeur vers la fonction SecureMemoryCacheCallback définie par l’application à inscrire.

Valeur retournée

Si la fonction réussit, elle inscrit la fonction de rappel et retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

Remarques

Une application qui effectue des E/S directement sur un appareil hautes performances met généralement en cache un mappage de mémoire virtuelle à physique pour la mémoire tampon qu’elle utilise pour les E/S. Le pilote de l’appareil sécurise généralement cette plage d’adresses mémoire en appelant la routine MmSecureVirtualMemory , ce qui empêche la plage de mémoire d’être libérée ou ses protections modifiées jusqu’à ce que le pilote ne sécurise pas la mémoire.

Une application peut utiliser AddSecureMemoryCacheCallback pour inscrire une fonction de rappel qui sera appelée lorsque la mémoire sera libérée ou que ses protections sont modifiées, afin que l’application puisse invalider son mappage de mémoire mise en cache. Pour plus d’informations, consultez SecureMemoryCacheCallback.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback