Fonction RtlZeroVolatileMemory (wdm.h)

La fonction RtlZeroVolatileMemory est un wrapper pratique autour de RtlFillVolatileMemory.

Syntaxe

volatile void * RtlZeroVolatileMemory(
  [out] volatile void *Destination,
  [in]  size_t        Length
);

Paramètres

[out] Destination

Pointeur vers l’adresse de départ du bloc de mémoire à remplir avec des zéros.

[in] Length

Taille du bloc de mémoire à remplir avec des zéros, en octets.

Valeur retournée

Retourne la valeur de Destination.

Remarques

La fonction RtlZeroVolatileMemory est un wrapper pratique autour de RtlFillVolatileMemory.

Pour plus d’informations, consultez la section remarques de RtlFillVolatileMemory.

Notes

Cette fonction fonctionne sur toutes les versions de Windows, pas seulement sur la dernière version. Vous devez utiliser le dernier WDK pour obtenir la déclaration de fonction à partir de l’en-tête wdm.h. Vous avez également besoin de la bibliothèque (volatileaccessk.lib) du dernier WDK. Toutefois, le pilote résultant s’exécute correctement sur les versions antérieures de Windows.

Exemple

UCHAR SensitiveData[100];

// Imagine we temporarily store some sensitive cryptographic
// material in a buffer.

StoreCryptographicKey(&SensitiveData);
DoCryptographicOperation(&SensitiveData);

// Now that we are done using the sensitive data we want to
// erase it from the stack. We cannot call RtlFillMemory because
// if the compiler realizes that "SensitiveData" is not
// referenced again the compiler can remove the call to RtlFillMemory.
// Instead we can call RtlSecureZeroMemory2, RtlZeroVolatileMemory, or RtlFillVolatileMemory
// (the former two are convenience wrappers around the latter). These
// calls will not be optimized away by the compiler.
// Note that RtlSecureZeroMemory2 performs better than the
// RtlSecureZeroMemory function.

RtlZeroVolatileMemory(&SensitiveData, sizeof(SensitiveData));

Configuration requise

Condition requise	Valeur
En-tête	wdm.h (inclure Wdm.h)
Bibliothèque	volatileaccessk.lib (mode noyau), volatileaccessu.lib (mode utilisateur)

Voir aussi

RtlFillVolatileMemory