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. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la función CryptGenRandom .]

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.
 

Sintaxis

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.

Comentarios

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecapi.h
Archivo DLL Advapi32.dll