ホーム › Security.Cryptography › NCryptFinalizeKeyFn

NCryptFinalizeKeyFn

コールバック

シグネチャ

HRESULT NCryptFinalizeKeyFn(
    NCRYPT_PROV_HANDLE hProvider,
    NCRYPT_KEY_HANDLE hKey,
    DWORD dwFlags
);

パラメーター

フィールド

型

説明

hProvider

NCRYPT_PROV_HANDLE

hKey

NCRYPT_KEY_HANDLE

完成させるキーのハンドルです。このハンドルは、NCryptCreatePersistedKey 関数を呼び出して取得します。

dwFlags

DWORD

関数の動作を変更するフラグです。0、または次の値の 1 つ以上を組み合わせて指定できます。

値	意味
NCRYPT_NO_KEY_VALIDATION	キーペアの公開部分を検証しません。このフラグは、公開キーと秘密キーのペアにのみ適用されます。
NCRYPT_WRITE_KEY_TO_LEGACY_STORE_FLAG	キーをレガシーストレージにも保存します。これにより、そのキーを CryptoAPI で使用できるようになります。このフラグは RSA キーにのみ適用されます。
NCRYPT_SILENT_FLAG	キーストレージプロバイダー (KSP) がユーザーインターフェイスを表示しないように要求します。プロバイダーが動作するために UI を表示する必要がある場合、呼び出しは失敗し、KSP は最後のエラーとして NTE_SILENT_CONTEXT エラーコードを設定します。

公式ドキュメント

NCryptFinalizeKey 関数は、CNG のキーストレージキーを完成させます。この関数が呼び出されるまで、そのキーは使用できません。

戻り値

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

返される可能性のあるコードには、次のものがあります (ただしこれらに限定されません)。

戻り値	説明
ERROR_SUCCESS	関数は成功しました。
NTE_BAD_FLAGS	dwFlags パラメーターに有効でない値が含まれています。
NTE_INVALID_HANDLE	hKey パラメーターが有効ではありません。

解説(Remarks)

サービスは、StartService 関数からこの関数を呼び出してはなりません。サービスが StartService 関数からこの関数を呼び出すと、デッドロックが発生し、サービスが応答しなくなる場合があります。

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