IOCTL_HAL_GET_RANDOM_SEED (Windows CE 5.0)

Send Feedback

This IOCTL returns random bytes from a hardware source.

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_HAL_GET_RANDOM_SEED.
  • lpInBuf
    [in] Set to NULL.
  • nInBufSize
    [in] Set to zero.
  • lpOutBuf
    [in] Set to the address of an allocated output buffer for storing the random bytes.
  • nOutBufSize
    [in] Set to the size of the output buffer. This value must be less than or equal to 1024.
  • lpBytesReturned
    [in] DWORD pointer to receive the size of data returned (up to 24 bytes) in lpOutBuf.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

This request is used by the random number generator to query the platform hardware for additional sources of random data, such as a high-frequency counter or real-time clock. If the system has provided support for IOCTL_HAL_GET_RANDOM_SEED, TRUE is returned for a successful operation. The number of bytes of random data returned can be less than nOutBufSize, in which case the remaining bytes will be zeroed If no suitable random source is present on the platform or the request fails, FALSE is returned. If FALSE is returned, call GetLastError for information.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Pkfuncs.h.

See Also

Security IOCTLs

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.