blob: 4f21e88a380630792dd9fbccbbf382d9120f9fa5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
@deftypefun {int} {gnutls_x509_crt_get_dn_oid} (gnutls_x509_crt_t @var{cert}, unsigned @var{indx}, void * @var{oid}, size_t * @var{oid_size})
@var{cert}: should contain a @code{gnutls_x509_crt_t} type
@var{indx}: This specifies which OID to return. Use (0) to get the first one.
@var{oid}: a pointer to a buffer to hold the OID (may be null)
@var{oid_size}: initially holds the size of @code{oid}
This function will extract the OIDs of the name of the Certificate
subject specified by the given index.
If @code{oid} is null then only the size will be filled. The @code{oid} returned will be null terminated, although @code{oid_size} will not
account for the trailing null.
@strong{Returns:} @code{GNUTLS_E_SHORT_MEMORY_BUFFER} if the provided buffer is not
long enough, and in that case the @code{buf_size} will be updated with
the required size. @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE} if there
are no data in the current index. On success 0 is returned.
@end deftypefun
|