Win32 API 日本語リファレンス
ホーム › Security.Cryptography › BCryptFinalizeKeyPairFn

BCryptFinalizeKeyPairFn

コールバック

シグネチャ

NTSTATUS BCryptFinalizeKeyPairFn(
    BCRYPT_KEY_HANDLE hKey,
    DWORD dwFlags
);

パラメーター

フィールド型説明
hKeyBCRYPT_KEY_HANDLE完成させるキーのハンドルです。このハンドルは、BCryptGenerateKeyPair 関数を呼び出して取得します。
dwFlagsDWORDこの関数の動作を変更するフラグのセットです。現在定義されているフラグはないため、このパラメーターには 0 を指定してください。

公式ドキュメント

BCryptFinalizeKeyPair 関数は、公開/秘密キーのペアを完成させます。この関数が呼び出されるまで、キーは使用できません。この関数を呼び出した後は、このキーに対して BCryptSetProperty 関数を使用できなくなります。

戻り値

関数の成功または失敗を示すステータスコードを返します。

返される可能性のあるコードには、以下のものが含まれます (これらに限定されません)。

戻り値 説明
STATUS_SUCCESS
 関数は成功しました。
STATUS_INVALID_HANDLE
 hKey パラメーターのキーのハンドルが無効です。
STATUS_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。
STATUS_NOT_SUPPORTED
 指定されたプロバイダーは、非対称キーの暗号化をサポートしていません。

解説(Remarks)

サポートされているアルゴリズムプロバイダーを使用する場合、BCryptFinalizeKeyPair はユーザーモードとカーネルモードのどちらからでも呼び出せます。カーネルモードの呼び出し元は、PASSIVE_LEVEL IRQL または DISPATCH_LEVEL IRQL のいずれでも実行できます。現在の IRQL レベルが DISPATCH_LEVEL の場合、hKey パラメーターに指定するハンドルは、BCRYPT_PROV_DISPATCH フラグを指定して開かれたプロバイダーが返したアルゴリズムハンドルから派生したものである必要があります。

この関数をカーネルモードで呼び出すには、Driver Development Kit (DDK) に含まれる Cng.lib を使用します。Windows Server 2008 および Windows Vista: この関数をカーネルモードで呼び出すには、Ksecdd.lib を使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)