ホーム › Security.Cryptography › PCRYPT_ENCRYPT_PRIVATE_KEY_FUNC

PCRYPT_ENCRYPT_PRIVATE_KEY_FUNC

コールバック

シグネチャ

BOOL PCRYPT_ENCRYPT_PRIVATE_KEY_FUNC(
    CRYPT_ALGORITHM_IDENTIFIER* pAlgorithm,
    CRYPT_INTEGER_BLOB* pClearTextPrivateKey,
    BYTE* pbEncryptedKey,
    DWORD* pcbEncryptedKey,
    void* pVoidEncryptFunc
);

パラメーター

フィールド	型	説明
pAlgorithm	CRYPT_ALGORITHM_IDENTIFIER*	PKCS #8 標準で定義されている PrivateKeyInfo ASN.1 型の暗号化に使用したアルゴリズムを受け取る CRYPT_ALGORITHM_IDENTIFIER 構造体へのポインターです。
pClearTextPrivateKey	CRYPT_INTEGER_BLOB*	暗号化する平文の秘密鍵を格納する CRYPT_DATA_BLOB 構造体へのポインターです。
pbEncryptedKey	BYTE*	暗号化された秘密鍵 BLOB を受け取る BYTE バッファーへのポインターです。このパラメーターが NULL の場合、pcbEncryptedKey には、次回この関数を呼び出したときに暗号化されたキーを格納するために必要なメモリのサイズ (バイト単位) が返されます。
pcbEncryptedKey	DWORD*	pbEncryptedKey バッファーのサイズ (バイト単位) を格納する DWORD 変数へのポインターです。pbEncryptedKey が NULL の場合、pcbEncryptedKey にはキーの暗号化に必要なサイズ (バイト単位) が設定されます。詳細については、 Retrieving Data of Unknown Length を参照してください。
pVoidEncryptFunc	void*	キー、初期化ベクター、パスワードなど、暗号化に使用するデータを格納する LPVOID 変数です。

公式ドキュメント

[PCRYPT_ENCRYPT_PRIVATE_KEY_FUNC 関数は、「要件」セクションに示されたオペレーティングシステムで使用できます。以降のバージョンでは変更されるか、使用できなくなる可能性があります。]

PCRYPT_ENCRYPT_PRIVATE_KEY_FUNC 関数は、秘密鍵を暗号化し、暗号化された内容を pbEncryptedKey パラメーターに返します。この関数は、PKCS #8 の CRYPT_ENCRYPTED_PRIVATE_KEY_INFO 構造体を作成する CRYPT_PKCS8_EXPORT_PARAMS 構造体で指定されるコールバック関数です。この関数は、アプリケーションごとの要件に合わせて開発者が実装する必要があります。

戻り値

関数が成功した場合は、0 以外の値 (TRUE) を返します。

関数が失敗した場合は、0 (FALSE) を返します。

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