BCryptConfigureContextFunction 関数 (bcrypt.h)

  • [アーティクル]

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

BCryptConfigureContextFunction 関数は、既存の CNG コンテキストの暗号化関数の構成情報を設定します。

構文

NTSTATUS BCryptConfigureContextFunction(
  [in] ULONG                          dwTable,
  [in] LPCWSTR                        pszContext,
  [in] ULONG                          dwInterface,
  [in] LPCWSTR                        pszFunction,
  [in] PCRYPT_CONTEXT_FUNCTION_CONFIG pConfig
);

パラメーター

[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] pConfig

新しい関数構成情報を含む CRYPT_CONTEXT_FUNCTION_CONFIG 構造体のアドレス。

戻り値

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

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

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

注釈

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

要件

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

こちらもご覧ください

CRYPT_CONTEXT_FUNCTION_CONFIG