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

この関数の動作を変更するフラグのセット。 現在、フラグは定義されていないため、このパラメーターは 0 である必要があります。

戻り値

関数の成功または失敗を示す状態コードを返します。

可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード	説明
STATUS_SUCCESS	関数は成功しました。
STATUS_INVALID_PARAMETER	1 つ以上のパラメーターが無効です。
STATUS_NO_MEMORY	メモリ割り当てエラーが発生しました。

注釈

BCryptEnumProviders は、ユーザー モードまたはカーネル モードから呼び出すことができます。 カーネル モードの呼び出し元は、PASSIVE_LEVEL IRQL で実行されている必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	bcrypt.h
Library	Bcrypt.lib
[DLL]	Bcrypt.dll

こちらもご覧ください

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer