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_LEVEL IRQL で実行されている必要があります。

要件

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