Fonction RtlGenRandom (ntsecapi.h)

[La fonction RtlGenRandom est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt la fonction CryptGenRandom .]

La fonction RtlGenRandom génère un nombre pseudo-aléatoire.

Note Cette fonction n’a pas de bibliothèque d’importation associée. Cette fonction est disponible en tant que ressource nommée SystemFunction036 dans Advapi32.dll. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers Advapi32.dll.

 

Syntaxe

BOOLEAN RtlGenRandom(
  [out] PVOID RandomBuffer,
  [in]  ULONG RandomBufferLength
);

Paramètres

[out] RandomBuffer

Pointeur vers une mémoire tampon qui reçoit le nombre aléatoire sous forme de données binaires. La taille de cette mémoire tampon est spécifiée par le paramètre RandomBufferLength .

[in] RandomBufferLength

Longueur, en octets, de la mémoire tampon RandomBuffer .

Valeur retournée

Si la fonction réussit, la fonction retourne TRUE.

Si la fonction échoue, elle retourne FALSE.

Remarques

Lorsque vous avez terminé d’utiliser le nombre aléatoire, libérez la mémoire tampon RandomBuffer en appelant la fonction SecureZeroMemory .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ntsecapi.h
DLL	Advapi32.dll