BCryptEncryptFn

暗号化中に使用する 初期化ベクター (IV) を格納しているバッファーのアドレスです。cbIV パラメーターには、このバッファーのサイズを指定します。この関数は、このバッファーの内容を変更します。後で IV を再利用する必要がある場合は、この関数を呼び出す前にこのバッファーのコピーを作成しておいてください。

このパラメーターは省略可能であり、IV を使用しない場合は NULL を指定できます。

IV に必要なサイズは、BCryptGetProperty 関数を呼び出して BCRYPT_BLOCK_LENGTH プロパティを取得することで得られます。これによりアルゴリズムのブロックのサイズが得られ、これが IV のサイズにもなります。

この関数が生成する 暗号文 を受け取るバッファーのアドレスです。cbOutput パラメーターには、このバッファーのサイズを指定します。詳細については「解説」を参照してください。

このパラメーターが NULL の場合、BCryptEncrypt 関数は、pbInput パラメーターで渡されたデータの暗号文に必要なサイズを計算します。この場合、pcbResult パラメーターが指す場所にそのサイズが格納され、関数は STATUS_SUCCESS を返します。pPaddingInfo パラメーターは変更されません。

pbOutput パラメーターと pbInput パラメーターの値がどちらも NULL の場合、認証付き暗号化アルゴリズムを使用しているときを除き、エラーが返されます。使用している場合、この呼び出しは長さ 0 のデータに対する認証付き暗号化の呼び出しとして扱われ、認証タグが pPaddingInfo パラメーターに返されます。

この関数の動作を変更するフラグのセットです。指定できるフラグのセットは、hKey パラメーターで指定したキーの種類によって異なります。

キーが対称キーの場合、0 または次の値を指定できます。

キーが非対称キーの場合、次のいずれかの値を指定できます。