Funzione RtlGenRandom (ntsecapi.h)

[La funzione RtlGenRandom è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece la funzione CryptGenRandom .

La funzione RtlGenRandom genera un numero pseudo-casuale.

Nota Questa funzione non ha una libreria di importazione associata. Questa funzione è disponibile come risorsa denominata SystemFunction036 in Advapi32.dll. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Advapi32.dll.

 

Sintassi

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

Parametri

[out] RandomBuffer

Puntatore a un buffer che riceve il numero casuale come dati binari. Le dimensioni di questo buffer vengono specificate dal parametro RandomBufferLength .

[in] RandomBufferLength

Lunghezza, in byte, del buffer RandomBuffer .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE.

Commenti

Al termine dell'uso del numero casuale, liberare il buffer RandomBuffer chiamando la funzione SecureZeroMemory .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntsecapi.h
DLL	Advapi32.dll