Поделиться через


Функция RtlGenRandom (ntsecapi.h)

[Функция RtlGenRandom доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте функцию CryptGenRandom .]

Функция RtlGenRandom создает псевдослучайное число.

Примечание У этой функции нет связанной библиотеки импорта. Эта функция доступна в виде ресурса SystemFunction036 в Advapi32.dll. Для динамического связывания с Advapi32.dll необходимо использовать функции LoadLibrary и GetProcAddress .
 

Синтаксис

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

Параметры

[out] RandomBuffer

Указатель на буфер, который получает случайное число в виде двоичных данных. Размер этого буфера определяется параметром RandomBufferLength .

[in] RandomBufferLength

Длина буфера RandomBuffer в байтах.

Возвращаемое значение

Если функция выполняется успешно, функция возвращает значение TRUE.

Если функция завершается сбоем, она возвращает значение FALSE.

Комментарии

Завершив использование случайного числа, освободите буфер RandomBuffer , вызвав функцию SecureZeroMemory .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntsecapi.h
DLL Advapi32.dll