共用方式為

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

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

傳回值

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

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

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

備註

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

規格需求

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

另請參閱

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer