BCryptSetContextFunctionProperty 関数 (bcrypt.h)

  • [アーティクル]

BCryptSetContextFunctionProperty 関数は、既存の CNG コンテキストの暗号化関数の名前付きプロパティの値を設定します。

構文

NTSTATUS BCryptSetContextFunctionProperty(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] LPCWSTR pszProperty,
  [in] ULONG   cbValue,
  [in] PUCHAR  pbValue
);

パラメーター

[in] dwTable

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

値 意味
CRYPT_LOCAL
 コンテキストは、local-machine 構成テーブルに存在します。
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 関数の一覧に存在します。

[in] pszFunction

プロパティを設定する暗号化関数の識別子を含む null で終わる Unicode 文字列へのポインター。

[in] pszProperty

設定するプロパティの識別子を含む null で終わる Unicode 文字列へのポインター。

[in] cbValue

pbValue バッファーのサイズをバイト単位で格納します。 これは、格納される正確なバイト数です。 プロパティ値が文字列の場合は、必要に応じて、終端の null 文字も格納するために 1 文字のサイズを追加する必要があります。

[in] pbValue

新しいプロパティ値を含むバッファーのアドレス。

戻り値

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

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

リターン コード 説明
STATUS_SUCCESS
 関数は成功しました。
STATUS_ACCESS_DENIED
 呼び出し元は、関数のプロパティへの書き込みアクセス権を持っていません。
STATUS_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。
STATUS_NO_MEMORY
 メモリ割り当てエラーが発生しました。
STATUS_NOT_FOUND
 指定されたコンテキストまたは関数が見つかりませんでした。

注釈

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

要件

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