キーストレージプロバイダー (KSP) を使用した NCryptExportKey - AWS CloudHSM

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

キーストレージプロバイダー (KSP) を使用した NCryptExportKey

NCryptExportKey 関数は KSP キーをメモリ BLOB にエクスポートします。この関数は、パブリックキーのエクスポートのみをサポートします。

パラメータ

hKey [in]

エクスポートするキーのハンドル。

hExportKey [in, unused]

AWS CloudHSM Key Storage Provider (KSP) はこのパラメータを使用しません。

pszBlobType [in]

エクスポートするBLOBタイプを指定する NULL 終了 Unicode 文字列。 AWS CloudHSM キーストレージプロバイダー (KSP) は次の値をサポートします。

意味

BCRYPT_RSAPUBLIC_BLOB

RSA パブリックキーをエクスポートします。pbOutput バッファには、キーデータの後に続く BCRYPT_RSAKEY_BLOB 構造が含まれています。

BCRYPT_ECCPUBLIC_BLOB

ECC パブリックキーをエクスポートします。pbOutput バッファには、キーデータの後に続く BCRYPT_ECCKEY_BLOB 構造が含まれています。

pParameterList [in, unused]

AWS CloudHSM Key Storage Provider (KSP) はこのパラメータを使用しません。

pbOutput [out, optional]

キー BLOB を保存するバッファアドレス。cbOutput を使用してバッファサイズを指定します。NULL に設定すると、関数は pcbResult が指す DWORD に必要なサイズ (バイト単位) を保存します。

cbOutput [in]

pbOutput バッファのサイズ (バイト単位)。

pcbResult [out]

pbOutput バッファにコピーされたバイト数を保存する DWORD 変数アドレス。pbOutput が NULL の場合、関数は必要なバッファサイズをバイト単位で保存します。

dwFlags [in]

関数の動作を変更するためのフラグ。ゼロまたは以下の値を使用できます。

意味

NCRYPT_SILENT_FLAG

このフラグは効果がありません。

戻り値

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

一般的なリターンコードは次のとおりです。

リターンコード 説明

ERROR_SUCCESS

オペレーションが正常に完了しました。

NTE_INVALID_PARAMETER

1 つ以上のパラメータが無効です。

NTE_FAIL

オペレーションを完了できませんでした。

NTE_INVALID_HANDLE

hProvider のハンドルが無効です。

NTE_BAD_FLAGS

dwFlags パラメータに無効な値が含まれています。

NTE_BAD_KEY_STATE

キーの状態が無効です。

NTE_NOT_SUPPORTED

pszBlobType または dwFlags パラメータにサポートされていない値が含まれています。

STATUS_INTERNAL_ERROR

オペレーション中に内部エラーが発生しました。