comparison libpurple/certificate.h @ 32552:298080cecdc5

Add a function for converting a PurpleCertificate to a string suitable for display to the user. This is basically just a copy of purple_certificate_display_x509 right now, but it will eventually lead somewhere...
author Elliott Sales de Andrade <qulogic@pidgin.im>
date Sun, 26 Feb 2012 03:01:41 +0000
parents 98520ee78f12
children 32642aa8dbe5
comparison
equal deleted inserted replaced
32551:c775aca73d75 32552:298080cecdc5
259 * @return Binary DER representation of certificate - must be freed using 259 * @return Binary DER representation of certificate - must be freed using
260 * g_byte_array_free() 260 * g_byte_array_free()
261 */ 261 */
262 GByteArray * (* get_der_data)(PurpleCertificate *crt); 262 GByteArray * (* get_der_data)(PurpleCertificate *crt);
263 263
264 /**
265 * Retrieves a string representation of the certificate suitable for display
266 *
267 * @param crt Certificate instance
268 * @return User-displayable string representation of certificate - must be
269 * freed using g_free().
270 */
271 gchar * (* get_display_string)(PurpleCertificate *crt);
272
264 void (*_purple_reserved1)(void); 273 void (*_purple_reserved1)(void);
265 void (*_purple_reserved2)(void);
266 }; 274 };
267 275
268 /** A set of operations used to provide logic for verifying a Certificate's 276 /** A set of operations used to provide logic for verifying a Certificate's
269 * authenticity. 277 * authenticity.
270 * 278 *
575 * g_byte_array_free(). 583 * g_byte_array_free().
576 */ 584 */
577 GByteArray * 585 GByteArray *
578 purple_certificate_get_der_data(PurpleCertificate *crt); 586 purple_certificate_get_der_data(PurpleCertificate *crt);
579 587
588 /**
589 * Retrieves a string suitable for displaying a certificate to the user.
590 *
591 * @param crt Certificate instance
592 *
593 * @return String representing the certificate that may be displayed to the user
594 * - must be freed using g_free().
595 */
596 char *
597 purple_certificate_get_display_string(PurpleCertificate *crt);
598
580 /*@}*/ 599 /*@}*/
581 600
582 /*****************************************************************************/ 601 /*****************************************************************************/
583 /** @name Certificate Pool Functions */ 602 /** @name Certificate Pool Functions */
584 /*****************************************************************************/ 603 /*****************************************************************************/