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 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー bcrypt.h
Library Bcrypt.lib
[DLL] Bcrypt.dll

こちらもご覧ください

BCryptRemoveContextFunction