BCryptExportKey 関数 (bcrypt.h)

BCryptExportKey 関数は、後で使用するために永続化できるメモリ BLOB にキーをエクスポートします。

構文

NTSTATUS BCryptExportKey(
  [in]  BCRYPT_KEY_HANDLE hKey,
  [in]  BCRYPT_KEY_HANDLE hExportKey,
  [in]  LPCWSTR           pszBlobType,
  [out] PUCHAR            pbOutput,
  [in]  ULONG             cbOutput,
  [out] ULONG             *pcbResult,
  [in]  ULONG             dwFlags
);

パラメーター

[in] hKey

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

[in] hExportKey

エクスポートされたキーをラップするキーのハンドル。 BCRYPT_AES_WRAP_KEY_BLOB型の BLOB をエクスポートする場合は、このパラメーターを使用します。それ以外の場合は、NULLに設定します。

Windows Server 2008 および Windows Vista: このパラメーターは使用されず、nullに設定する必要があります。

[in] pszBlobType

エクスポートする BLOB の種類を指定する識別子を含む null で終わる Unicode 文字列。 次のいずれかの値を指定できます。

[out] pbOutput

キー BLOB を受け取るバッファーのアドレス。 cbOutput パラメーターには、このバッファーのサイズが含まれています。 このパラメーターが NULL場合、この関数は必要なサイズ (バイト単位) を、pcbResult パラメーターによって指 ULONG に配置します。

[in] cbOutput

pbOutput バッファーのサイズ (バイト単位) を格納します。

[out] pcbResult

pbOutput バッファーにコピーされたバイト数を受け取る ULONG へのポインター。 pbOutput パラメーターが NULL場合、この関数は必要なサイズ (バイト単位) を、このパラメーターによって指 ULONG に配置します。

[in] dwFlags

この関数の動作を変更するフラグのセット。 この関数にはフラグは定義されていません。

戻り値

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

可能な戻りコードには、以下が含まれますが、これらに限定されません。

備考

プロバイダーがサポートするプロセッサ モードに応じて、BCryptExportKey は、ユーザー モードまたはカーネル モードから呼び出すことができます。 カーネル モードの呼び出し元は、PASSIVE_LEVELIRQL または DISPATCH_LEVEL IRQL で実行できます。 現在の IRQL レベルが DISPATCH_LEVELされている場合、hKey パラメーターで指定されたハンドルは、BCRYPT_PROV_DISPATCH フラグを使用して開かれたプロバイダーによって返されるアルゴリズム ハンドルから派生する必要があり、BCryptExportKey 関数に渡されるすべてのポインターは、非ページ (またはロックされた) メモリを参照する必要があります。

カーネル モードでこの関数を呼び出すには、ドライバー開発キット (DDK) の一部である Cng.lib を使用します。 Windows Server 2008 および Windows Vista: カーネル モードでこの関数を呼び出すには、Ksecdd.lib を使用します。

必要条件

関連項目

BCryptImportKey

BCryptImportKeyPair