Compartilhar via


Função RtlGenRandom (ntsecapi.h)

[A função RtlGenRandom está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. Em vez disso, use as funções BCryptGenRandom ou ProcessPrng .]

A função RtlGenRandom gera um número pseudo-aleatório.

Nota Essa função não tem nenhuma biblioteca de importação associada. Essa função está disponível como um recurso chamado SystemFunction036 no Advapi32.dll. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Advapi32.dll.
 

Sintaxe

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

Parâmetros

[out] RandomBuffer

Um ponteiro para um buffer que recebe o número aleatório como dados binários. O tamanho desse buffer é especificado pelo parâmetro RandomBufferLength .

[in] RandomBufferLength

O comprimento, em bytes, do buffer RandomBuffer .

Valor de retorno

Se a função for bem-sucedida, a função retornará TRUE.

Se a função falhar, ela retornará FALSE.

Observações

Quando terminar de usar o número aleatório, libere o buffer RandomBuffer chamando a função SecureZeroMemory .

Requirements

Requirement Value
Cliente mínimo suportado Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header ntsecapi.h
de DLL Advapi32.dll