Blame doc/functions/gnutls_x509_crl_iter_crt_serial

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_x509_crl_iter_crt_serial} (gnutls_x509_crl_t @var{crl}, gnutls_x509_crl_iter_t * @var{iter}, unsigned char * @var{serial}, size_t * @var{serial_size}, time_t * @var{t})
Packit Service 4684c1
@var{crl}: should contain a @code{gnutls_x509_crl_t}  type
Packit Service 4684c1
Packit Service 4684c1
@var{iter}: A pointer to an iterator (initially the iterator should be @code{NULL} )
Packit Service 4684c1
Packit Service 4684c1
@var{serial}: where the serial number will be copied
Packit Service 4684c1
Packit Service 4684c1
@var{serial_size}: initially holds the size of serial
Packit Service 4684c1
Packit Service 4684c1
@var{t}: if non null, will hold the time this certificate was revoked
Packit Service 4684c1
Packit Service 4684c1
This function performs the same as @code{gnutls_x509_crl_get_crt_serial()} ,
Packit Service 4684c1
but reads sequentially and keeps state in the iterator 
Packit Service 4684c1
between calls. That allows it to provide better performance in sequences 
Packit Service 4684c1
with many elements (50000+).
Packit Service 4684c1
Packit Service 4684c1
When past the last element is accessed @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE} 
Packit Service 4684c1
is returned and the iterator is reset.
Packit Service 4684c1
Packit Service 4684c1
After use, the iterator must be deinitialized using @code{gnutls_x509_crl_iter_deinit()} .
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
Packit Service 4684c1
negative error value.
Packit Service 4684c1
@end deftypefun