RtlGenRandom-Funktion (ntsecapi.h)

Artikel
02/29/2024

[Die RtlGenRandom-Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Funktion CryptGenRandom .]

Die RtlGenRandom-Funktion generiert eine Pseudo-Zufallszahl.

Hinweis Diese Funktion verfügt über keine zugeordnete Importbibliothek. Diese Funktion ist als Ressource mit dem Namen SystemFunction036 in Advapi32.dll verfügbar. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Advapi32.dll zu verknüpfen.

Syntax

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

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 TRUE zurück.

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

Hinweise

Wenn Sie die Zufallszahl verwendet haben, geben Sie den RandomBuffer-Puffer frei, indem Sie die SecureZeroMemory-Funktion aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecapi.h
DLL	Advapi32.dll

Freigeben über