Blame doc/functions/gnutls_system_key_iter_get_info
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@deftypefun {int} {gnutls_system_key_iter_get_info} (gnutls_system_key_iter_t * @var{iter}, unsigned @var{cert_type}, char ** @var{cert_url}, char ** @var{key_url}, char ** @var{label}, gnutls_datum_t * @var{der}, unsigned int @var{flags})
|
|
Packit Service |
4684c1 |
@var{iter}: an iterator of the system keys (must be set to @code{NULL} initially)
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{cert_type}: A value of gnutls_certificate_type_t which indicates the type of certificate to look for
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{cert_url}: The certificate URL of the pair (may be @code{NULL} )
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{key_url}: The key URL of the pair (may be @code{NULL} )
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{label}: The friendly name (if any) of the pair (may be @code{NULL} )
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{der}: if non-NULL the DER data of the certificate
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{flags}: should be zero
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
This function will return on each call a certificate
|
|
Packit Service |
4684c1 |
and key pair URLs, as well as a label associated with them,
|
|
Packit Service |
4684c1 |
and the DER-encoded certificate. When the iteration is complete it will
|
|
Packit Service |
4684c1 |
return @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE} .
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Typically @code{cert_type} should be @code{GNUTLS_CRT_X509} .
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
All values set are allocated and must be cleared using @code{gnutls_free()} ,
|
|
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 |
|
|
Packit Service |
4684c1 |
@strong{Since:} 3.4.0
|
|
Packit Service |
4684c1 |
@end deftypefun
|