次の方法で共有


BCryptAddContextFunction 関数 (bcrypt.h)

[BCryptAddContextFunction は、[要件] セクションで指定されたオペレーティング システムで使用できます。 それ以降のバージョンでは、変更または使用できない可能性があります。

BCryptAddContextFunction 関数は、既存の CNG コンテキストでサポートされている関数の一覧に暗号化関数を追加します。

構文

NTSTATUS BCryptAddContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] ULONG   dwPosition
);

パラメーター

[in] dwTable

コンテキストが存在する構成テーブルを識別します。 次のいずれかの値を指定できます。

価値 意味
CRYPT_LOCAL
コンテキストは、ローカル コンピューター構成テーブルに存在します。
CRYPT_DOMAIN
この値は使用できません。

[in] pszContext

関数を追加するコンテキストの識別子を含む null で終わる Unicode 文字列へのポインター。

[in] dwInterface

関数を追加する暗号化インターフェイスを識別します。 次のいずれかの値を指定できます。

価値 意味
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
非対称暗号化関数の一覧に関数を追加します。
BCRYPT_CIPHER_INTERFACE
暗号関数の一覧に関数を追加します。
BCRYPT_HASH_INTERFACE
ハッシュ関数の一覧に関数を追加します。
BCRYPT_RNG_INTERFACE
乱数ジェネレーター関数の一覧に関数を追加します。
BCRYPT_SECRET_AGREEMENT_INTERFACE
シークレット アグリーメント関数の一覧に関数を追加します。
BCRYPT_SIGNATURE_INTERFACE
関数をシグネチャ関数の一覧に追加します。
NCRYPT_KEY_STORAGE_INTERFACE
キー ストレージ関数の一覧に関数を追加します。
NCRYPT_SCHANNEL_INTERFACE
Schannel 関数の一覧に関数を追加します。
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE
Schannel が TLS 1.2 に対して受け入れる署名スイートの一覧に関数を追加します。

Windows Vista および Windows Server 2008: この値はサポートされていません。

[in] pszFunction

追加する暗号化関数の識別子を含む null で終わる Unicode 文字列へのポインター。

[in] dwPosition

この関数を挿入するリスト内の位置を指定します。 関数は、既存の関数の前のこの位置に挿入されます。 CRYPT_PRIORITY_TOP 値は、リストの先頭に関数を挿入するために使用されます。 CRYPT_PRIORITY_BOTTOM 値は、リストの末尾に関数を挿入するために使用されます。

戻り値

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

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

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

備考

追加された関数が既にリストに含まれている場合は、削除され、新しい位置に挿入されます。

BCryptAddContextFunction は、ユーザー モードでのみ呼び出すことができます。

必要条件

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

関連項目

BCryptRemoveContextFunction