|
|
tpseal(3c)
Name
tpseal() - mark a typed message buffer for encryption
Synopsis
#include <atmi.h>
int tpseal(char *data, TPKEY hKey, long flags)
Description
tpseal() marks, or registers, a message buffer for encryption. The principal who owns hKey can decrypt this buffer and access its content. A buffer may be sealed for more than one recipient principal by making several calls to tpseal().
data must point to a valid typed message buffer either (1) previously allocated by a process calling tpalloc() or (2) delivered by the system to a receiving process. The content of the buffer may be modified after tpseal() is invoked.
When the message buffer pointed to by data is transmitted from a process, the public key software encrypts the message content and attaches an encryption envelope to the message buffer for each encryption registration request. An encryption envelope enables a receiving process to decrypt the message.
The flags argument is reserved for future use and must be set to 0.
Return Values
On failure, this function returns -1 and sets tperrno() to indicate the error condition.
Errors
See Also
tpkey_close(3c), tpkey_open(3c)
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|