UIDS_FROM_ID(3)

NAME
uids_from_id - find all UID's associated with a public key

SYNOPSIS
#include <pgplib.h>
int
uids_from_keyid(PGPKEYID id, PGPuserid_t ***uidpp);

DESCRIPTION
The public key record id is fetched and all associated user identifications are exctracted. Upon sucessful return, uidpp points to an array of pointers to structures holding user identifications. The array is NULL terminated. Both the array, the structures and their contents have been allocated by means of malloc and should be free'ed when no longer needed.

RETURN VALUES
If nothing goes wrong, 0 is returned. Otherwise, -1 is returned.

SEE ALSO
free(3) free_uid(PGPlib) get_pubkey_rec(PGPlib) malloc(3) PGPlib(3)

HISTORY
Written by Tage Stabell-Kulų. First appeared in PGPlib 0.1