Freigeben über


RtlGenRandom-Funktion (ntsecapi.h)

[Die RtlGenRandom-Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Funktionen BCryptGenRandom oder ProcessPrng .]

Die RtlGenRandom-Funktion generiert eine Pseudo-Zufallszahl.

Anmerkung Diese Funktion weist keine zugeordnete Importbibliothek auf. Diese Funktion ist als Ressource mit dem Namen SystemFunction036 in Advapi32.dllverfügbar. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Advapi32.dllzu verknüpfen.
 

Syntax

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

Die Parameter

[out] RandomBuffer

Ein Zeiger auf einen Puffer, der die Zufallszahl als Binärdaten empfängt. Die Größe dieses Puffers wird durch den RandomBufferLength-Parameter angegeben.

[in] RandomBufferLength

Die Länge des RandomBuffer-Puffers in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion WAHR zurück.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben.

Bemerkungen

Wenn Sie die Zufällige Zahl verwendet haben, geben Sie den RandomBuffer-Puffer frei, indem Sie die SecureZeroMemory-Funktion aufrufen.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Header ntsecapi.h
DLL Advapi32.dll