共用方式為

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。

PASSIVE_LEVELIRQL僅支援BCRYPT_USE_SYSTEM_PREFERRED_RNG。 如需詳細資訊，請參閱。

Windows Vista：沒有 SP2 不支援此旗標。

傳回值

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

可能的傳回碼包括，但不限於下列專案。

傳回碼 描述
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_LEVEL IRQL 上執行。 如果目前的 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 應用程式]
目標平臺 窗戶
標頭 bcrypt.h
連結庫 Bcrypt.lib 或 Cng.lib（核心模式）
DLL Bcrypt.dll