gnutls_x509_crl_iter_crt_serial (3) Linux Manual Page
gnutls_x509_crl_iter_crt_serial – API function
Synopsis
#include <gnutls/x509.h> int gnutls_x509_crl_iter_crt_serial(gnutls_x509_crl_t crl, gnutls_x509_crl_iter_t * iter, unsigned char * serial, size_t * serial_size, time_t * t);
Arguments
- gnutls_x509_crl_t crl
- should contain a gnutls_x509_crl_t structure
- gnutls_x509_crl_iter_t * iter
- A pointer to an iterator (initially the iterator should be NULL)
- unsigned char * serial
- where the serial number will be copied
- size_t * serial_size
- initially holds the size of serial
- time_t * t
- if non null, will hold the time this certificate was revoked
Description
This function performs the same as gnutls_x509_crl_get_crt_serial(), but reads sequentially and keeps state in the iterator between calls. That allows it to provide better performance in sequences with many elements (50000+).When past the last element is accessed GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned and the iterator is reset.
After use, the iterator must be deinitialized using gnutls_x509_crl_iter_deinit().
Returns
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.Reporting Bugs
Report bugs to <bugs [at] gnutls.org>.Home page: http://www.gnutls.org
Copyright
Copyright © 2001-2014 Free Software Foundation, Inc..Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.