photoid.h

   1 /*
   2  * photoid.h - Routines for OpenPGP id photos.
   3  *
   4  * Jonathan McDowell <noodles@earth.li>
   5  *
   6  * Copyright 2004 Project Purple
   7  *
   8  * $Id: photoid.h,v 1.2 2004/05/27 21:58:18 noodles Exp $
   9  */
  10
  11 #ifndef __PHOTOID_H__
  12 #define __PHOTOID_H__
  13
  14 #include "keystructs.h"
  15
  16 /**
  17  *      getphoto - returns an OpenPGP packet containing a photo id.
  18  *      @key: The key to return the photo id from.
  19  *      @index: The index of the photo to return.
  20  *      @photo: The photo data.
  21  *      @length: The length of the photo data.
  22  *
  23  *      This function returns the photo data contained in a supplied key.
  24  *      index specifies which photo id should be returned. If there's no such
  25  *      photo id NULL is returned. The returned data pointer refers to the key
  26  *      data supplied rather than a copy of it.
  27  */
  28 int getphoto(struct openpgp_publickey *key, int index, unsigned char **photo,
  29                 size_t *length);
  30
  31 #endif /* __PHOTOID_H__ */