共用方式為

BCryptGenRandom 函式 (bcrypt.h)

  • 發行項

BCryptGenRandom 函式會產生隨機數。

語法

NTSTATUS BCryptGenRandom(
  [in, out] BCRYPT_ALG_HANDLE hAlgorithm,
  [in, out] PUCHAR            pbBuffer,
  [in]      ULONG             cbBuffer,
  [in]      ULONG             dwFlags
);

參數

[in, out] hAlgorithm

使用 BCryptOpenAlgorithmProvider 函式所建立的演算法提供者句柄。 建立提供者時指定的演算法必須支援隨機數產生器介面。

[in, out] pbBuffer

接收隨機數的緩衝區位址。 此緩衝區的大小是由 cbBuffer 參數所指定。

[in] cbBuffer

pbBuffer 緩衝區的大小，以位元組為單位。

[in] dwFlags

一組旗標，可修改此函式的行為。 此參數可以是零或下列值。

值 意義
BCRYPT_RNG_USE_ENTROPY_IN_BUFFER
0x00000001
 此函式會使用 pbBuffer 緩衝區中的數位做為隨機數的額外 Entropy。 如果未指定此旗標，則此函式會針對 entropy 使用隨機數。

Windows 8 及更新版本：Windows 8 和更新版本中會忽略此旗標。
BCRYPT_USE_SYSTEM_PREFERRED_RNG
0x00000002
 使用系統慣用的隨機數產生器演算法。 hAlgorithm 參數必須是 NULL。

BCRYPT_USE_SYSTEM_PREFERRED_RNG僅在 IRQL PASSIVE_LEVEL支援。 如需詳細資訊，請參閱＜備註＞。

Windows Vista： 如果沒有SP2，則不支援此旗標。

傳回值

傳回狀態代碼，指出函式的成功或失敗。

可能的傳回碼包括但不限於下列各項。

傳回碼 Description
STATUS_SUCCESS
 函式成功。
STATUS_INVALID_HANDLE
 hAlgorithm 參數中的句柄無效。
STATUS_INVALID_PARAMETER
 一或多個參數無效。

備註

默認隨機數提供者會實作演算法來產生符合 NIST SP800-90 標準的隨機數，特別是該標準CTR_DRBG部分。

Windows Vista： 在 Windows Vista 搭配 Service Pack 1 (SP1 之前，) 默認隨機數提供者會實作演算法來產生符合 FIPS 186-2 標準的隨機數。

根據提供者支持的處理器模式， BCryptGenRandom 可以從使用者模式或核心模式呼叫。 核心模式呼叫端可以在 IRQL PASSIVE_LEVEL 或DISPATCH_LEVELIRQL 上執行。 如果目前的 IRQL 層級 DISPATCH_LEVEL， 則 hAlgorithm 參數中提供的句柄必須使用 BCRYPT_PROV_DISPATCH 旗標開啟，而且傳遞至 BCryptGenRandom 函式的任何指標都必須參考非分頁 (或鎖定的) 記憶體。Windows Vista： Microsoft 提供者不支援在 DISPATCH_LEVEL 呼叫。

若要在核心模式中呼叫此函式，請使用 Cng.lib，這是驅動程式開發工具包 (DDK) 的一部分。 Windows Server 2008 和 Windows Vista： 若要在核心模式中呼叫此函式，請使用 Ksecdd.lib。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 bcrypt.h
程式庫 Bcrypt.lib 或 Cng.lib (核心模式)
Dll Bcrypt.dll