BCryptEnumAlgorithms 関数 (bcrypt.h)

  • [アーティクル]

BCryptEnumAlgorithms 関数は、登録済みのアルゴリズム識別子の一覧を取得します。

構文

NTSTATUS BCryptEnumAlgorithms(
  [in]  ULONG                       dwAlgOperations,
  [out] ULONG                       *pAlgCount,
  [out] BCRYPT_ALGORITHM_IDENTIFIER **ppAlgList,
  [in]  ULONG                       dwFlags
);

パラメーター

[in] dwAlgOperations

列挙に含めるアルゴリズム操作の種類を指定する値。 これは、次の値の 1 つ以上の組み合わせにすることができます。

価値 意味
BCRYPT_CIPHER_OPERATION
0x00000001
 列挙型に暗号アルゴリズムを含めます。
BCRYPT_HASH_OPERATION
0x00000002
 列挙にハッシュ アルゴリズムを含めます。
BCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION
0x00000004
 列挙に非対称暗号化アルゴリズムを含めます。
BCRYPT_SECRET_AGREEMENT_OPERATION
0x00000008
 列挙体に秘密契約アルゴリズムを含めます。
BCRYPT_SIGNATURE_OPERATION
0x00000010
 列挙に署名アルゴリズムを含めます。
BCRYPT_RNG_OPERATION
0x00000020
 列挙型に乱数ジェネレーター (RNG) アルゴリズムを含めます。

[out] pAlgCount

ppAlgList 配列内の要素数を受け取る、ULONG 変数へのポインター。

[out] ppAlgList

登録済みのアルゴリズム識別子の配列を受け取る BCRYPT_ALGORITHM_IDENTIFIER 構造体ポインターのアドレス。 このポインターは、不要になったときに BCryptFreeBuffer 関数に渡す必要があります。

[in] dwFlags

この関数の動作を変更するフラグのセット。 この関数にはフラグは定義されていません。

戻り値

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

可能な戻りコードには、以下が含まれますが、これらに限定されません。

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

備考

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー bcrypt.h
ライブラリ Bcrypt.lib
DLL Bcrypt.dll