Partager via


Fonction RtlGenRandom (ntsecapi.h)

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

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

Note Cette fonction n’a aucune bibliothèque d’importation associée. Cette fonction est disponible sous la forme d’une ressource nommée SystemFunction036 dans Advapi32.dll. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour lier dynamiquement à 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 .

Spécifications

Requirement Valeur
Client minimum requis Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Fenêtres
Header ntsecapi.h
DLL Advapi32.dll