共用方式為

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

一組旗標，可修改此函式的行為。 目前沒有定義旗標，因此此參數必須為零。

傳回值

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

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

傳回碼 描述
STATUS_SUCCESS
 函式成功。
STATUS_INVALID_PARAMETER
 一或多個參數無效。
STATUS_NO_MEMORY
 發生記憶體配置失敗。

言論

BCryptEnumProviders 可以從使用者模式或核心模式呼叫。 核心模式呼叫端必須在 IRQL PASSIVE_LEVEL執行。

要求

要求 價值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平臺 窗戶
標頭 bcrypt.h
連結庫 Bcrypt.lib
DLL Bcrypt.dll

另請參閱

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer