BCryptCreateContext 関数 (bcrypt.h)

  • [アーティクル]

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

BCryptCreateContext 関数は、新しい CNG 構成コンテキストを作成します。

構文

NTSTATUS BCryptCreateContext(
  [in]           ULONG                 dwTable,
  [in]           LPCWSTR               pszContext,
  [in, optional] PCRYPT_CONTEXT_CONFIG pConfig
);

パラメーター

[in] dwTable

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

値 意味
CRYPT_LOCAL
 local-machine 構成テーブルにコンテキストを作成します。
CRYPT_DOMAIN
 この値は使用できません。

[in] pszContext

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

[in, optional] pConfig

新しいコンテキストの追加の構成データを含む CRYPT_CONTEXT_CONFIG 構造体へのポインター。 このパラメーターは、必要ない場合は NULL にすることができます。

戻り値

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

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

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

注釈

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

要件

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