Compartir a través de


Función RtlGenRandom (ntsecapi.h)

[La función RtlGenRandom está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. En su lugar, use las funciones BCryptGenRandom o ProcessPrng .]

La función RtlGenRandom genera un número pseudoaleatorio.

Nota Esta función no tiene ninguna biblioteca de importación asociada. Esta función está disponible como un recurso denominado SystemFunction036 en Advapi32.dll. Debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Advapi32.dll.
 

Syntax

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

Parámetros

[out] RandomBuffer

Puntero a un búfer que recibe el número aleatorio como datos binarios. El tamaño de este búfer se especifica mediante el parámetro RandomBufferLength .

[in] RandomBufferLength

Longitud, en bytes, del búfer RandomBuffer .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve TRUE.

Si se produce un error en la función, devuelve FALSE.

Observaciones

Cuando haya terminado de usar el número aleatorio, libere el búfer RandomBuffer llamando a la función SecureZeroMemory .

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header ntsecapi.h
DLL de Advapi32.dll