Blame doc/functions/gnutls_x509_crt_get_subject_unique_id
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@deftypefun {int} {gnutls_x509_crt_get_subject_unique_id} (gnutls_x509_crt_t @var{crt}, char * @var{buf}, size_t * @var{buf_size})
|
|
Packit |
aea12f |
@var{crt}: Holds the certificate
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{buf}: user allocated memory buffer, will hold the unique id
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@var{buf_size}: size of user allocated memory buffer (on input), will hold
|
|
Packit |
aea12f |
actual size of the unique ID on return.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
This function will extract the subjectUniqueID value (if present) for
|
|
Packit |
aea12f |
the given certificate.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
If the user allocated memory buffer is not large enough to hold the
|
|
Packit |
aea12f |
full subjectUniqueID, then a GNUTLS_E_SHORT_MEMORY_BUFFER error will be
|
|
Packit |
aea12f |
returned, and buf_size will be set to the actual length.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
This function had a bug prior to 3.4.8 that prevented the setting
|
|
Packit |
aea12f |
of @code{NULL} @code{buf} to discover the @code{buf_size} . To use this function safely
|
|
Packit |
aea12f |
with the older versions the @code{buf} must be a valid buffer that can hold
|
|
Packit |
aea12f |
at least a single byte if @code{buf_size} is zero.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
@strong{Returns:} @code{GNUTLS_E_SUCCESS} on success, otherwise a negative error code.
|
|
Packit |
aea12f |
@end deftypefun
|