BCryptEnumProviders 函式 (bcrypt.h)
BCryptEnumProviders 函式會取得支援指定演算法的所有 CNG 提供者。
語法
NTSTATUS BCryptEnumProviders(
[in] LPCWSTR pszAlgId,
[out] ULONG *pImplCount,
[out] BCRYPT_PROVIDER_NAME **ppImplList,
[in] ULONG dwFlags
);
參數
[in] pszAlgId
以 Null 終止的 Unicode 字串指標,識別要為其取得提供者的演算法。 這可以是其中一個預先定義的 CNG 演演算法識別碼 或其他演算法識別碼。
[out] pImplCount
要接收 ppImplList 陣列中元素數目的 ULONG 變數指標。
[out] ppImplList
要接收支援指定演算法之提供者集合之 BCRYPT_PROVIDER_NAME 結構的數位位址。 pImplCount 參數會接收此陣列中的元素數目。 當不再需要此記憶體時,必須將此指標傳遞至 BCryptFreeBuffer 函式,以釋出此記憶體。
[in] dwFlags
一組旗標,可修改此函式的行為。 目前沒有定義旗標,因此此參數必須為零。
傳回值
傳回狀態代碼,指出函式的成功或失敗。
可能的傳回碼包括,但不限於下列專案。
傳回碼 | 描述 |
---|---|
|
函式成功。 |
|
一或多個參數無效。 |
|
發生記憶體配置失敗。 |
言論
BCryptEnumProviders 可以從使用者模式或核心模式呼叫。 核心模式呼叫端必須在 IRQL PASSIVE_LEVEL執行。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
支援的最低伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平臺 | 窗戶 |
標頭 | bcrypt.h |
連結庫 | Bcrypt.lib |
DLL | Bcrypt.dll |