Blame doc/functions/gnutls_x509_rdn_get_by_oid
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@deftypefun {int} {gnutls_x509_rdn_get_by_oid} (const gnutls_datum_t * @var{idn}, const char * @var{oid}, unsigned @var{indx}, unsigned int @var{raw_flag}, void * @var{buf}, size_t * @var{buf_size})
|
|
Packit |
aea12f |
@var{idn}: should contain a DER encoded RDN sequence
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{oid}: an Object Identifier
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{indx}: In case multiple same OIDs exist in the RDN indicates which
|
|
Packit |
aea12f |
to send. Use 0 for the first one.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{raw_flag}: If non-zero then the raw DER data are returned.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{buf}: a pointer to a structure to hold the peer's name
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{buf_size}: holds the size of @code{buf}
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
This function will return the name of the given Object identifier,
|
|
Packit |
aea12f |
of the RDN sequence. The name will be encoded using the rules
|
|
Packit |
aea12f |
from RFC4514.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, or
|
|
Packit |
aea12f |
@code{GNUTLS_E_SHORT_MEMORY_BUFFER} is returned and * @code{buf_size} is
|
|
Packit |
aea12f |
updated if the provided buffer is not long enough, otherwise a
|
|
Packit |
aea12f |
negative error value.
|
|
Packit |
aea12f |
@end deftypefun
|