秀丸メールマクロヘルプ21

PGP関係

PGP関係
- EncryptSign関数（TKInfo.dll）
- PgpEncrypt, PgpDecrypt, PgpGetInfo, PgpGetExitCode関数（TKInfo.dll）

EncryptSign関数（TKInfo.dll）

　EncryptSign関数は、現在編集中のメール上で、「編集・暗号化/電子署名...」の処理をします。パラメータで暗号化/電子署名の処理内容および形式等が指定できます。

　パラメータは、「編集・暗号化/電子署名...」のダイアログボックスとだいたい対応しています。

パラメータ１（数値型）

　処理の種類を指定します。0だと暗号化、1だと電子署名、2だと暗号化+電子署名です。

パラメータ２（数値型）

　形式および処理プログラムを指定します。0だとPGP、1だとGnuPG、2だとS/MIMEです。

パラメータ３（数値型）

　PGPまたはGnuPGを指定した場合には、PGP/MIME形式にするかどうかを指定します。0だと非PGP/MIME形式（本文だけ暗号化する形式）、1だとPGP/MIME形式となります。
　パラメータ２でS/MIME形式を指定している場合は、ここの数値の指定は無関係になります。

パラメータ４（数値型）

　パラメータ１にて暗号化または暗号化+電子署名を指定した場合に、復号できる人として送り主も含めるかどうか指定します。0だと含めない、1だと含めるです。
　パラメータ１が電子署名を指定してる場合は、ここの指定は無関係になります。

パラメータ５（文字列型）

　暗号化する場合に、復元できる人を指定します。このパラメータを省略するか、または数値の０を指定すると、メールの宛先に含まれるメールアドレス全部が対象となります。
　ここに適当なメールアドレスのリストを指定すると、メールの宛先は無視されて、ここで指定された人が「復元できる人」の対象となります。
　ここのパラメータで複数のメールアドレスを指定する場合は、メールアドレスをコンマで区切って指定してください。

返り値（文字列型）

　暗号化に失敗した場合は""が返り、成功した場合は何らかの意味のある文字列が返ります。
　PGP/GnuPGの場合は、成功した場合はその処理プログラムからのメッセージが返ります。

　暗号化に失敗した場合は、大抵の場合はEncryptSign関数の中でエラーメッセージが出てから復帰します。でも、一部、エラーメッセージが出ないで復帰することもあります。例えば、受信したメール上でこの関数を実行した場合はエラーメッセージが出ずにエラーで復帰します。

例（あとで送信/今すぐ送信の時に自動実行して電子署名する例）

question "電子署名を付けて送信しますか？";
if( result == yes ) {
    loaddll "tkinfo.dll";
    $s = dllfuncstr("EncryptSign", 1, 3, 0, 0);
    if( $s == "" ) {
        #n = dllfunc("SetCancel", 1);
    }
}