名前

tpsign()−デジタル署名のための型付きメッセージ・バッファのマーク

形式

#include <atmi.h>
int tpsign(char *data, TPKEY hKey, long flags)

機能説明

tpsign() は、hKey に関連するプリンシパルに代わって、デジタル署名のためのメッセージ・バッファをマーク (登録) します。

data は、(1) 以前 tpalloc() を呼び出すプロセスによって割り当てられたメッセージ・バッファ、または (2) システムによって受信プロセスに渡されたメッセージ・バッファのうち、いずれかの有効な型付きメッセージ・バッファを指している必要があります。バッファの内容は、tpsign() を起動してから修正することができます。

data が指すバッファがプロセスから伝送されると、デジタル署名登録要求に対して、公開鍵ソフトウェアがデジタル署名を生成し、メッセージ・バッファにアタッチします。デジタル署名によって、受信プロセスはメッセージの署名者 (発信者) を検証することができます。

引数 flags は使用されません。この引数は将来の用途のために予約されており、0 に設定します。

戻り値

異常終了すると、この関数は -1 を返し、tperrno を設定してエラー条件を示します。

エラー

関連項目