gnutls_x509_crq_get_attribute_info man page

gnutls_x509_crq_get_attribute_info — API function

Synopsis

#include <gnutls/x509.h>

int gnutls_x509_crq_get_attribute_info(gnutls_x509_crq_t crq, unsigned indx, void * oid, size_t * sizeof_oid);

Arguments

gnutls_x509_crq_t crq

should contain a gnutls_x509_crq_t type

unsigned indx

Specifies which attribute number to get. Use (0) to get the first one.

void * oid

a pointer to a structure to hold the OID

size_t * sizeof_oid

initially holds the maximum size of  oid , on return holds actual size of  oid .

Description

This function will return the requested attribute OID in the certificate, and the critical flag for it.  The attribute OID will be stored as a string in the provided buffer.  Use gnutls_x509_crq_get_attribute_data() to extract the data.

If the buffer provided is not long enough to hold the output, then * sizeof_oid is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned.

Returns

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code in case of an error.  If your have reached the last extension available GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.

Since

2.8.0

Reporting Bugs

Report bugs to <bugs@gnutls.org>.
Home page: http://www.gnutls.org

See Also

The full documentation for gnutls is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

http://www.gnutls.org/manual/

Info

3.5.10 gnutls