1
2
3
4
5@deftypefun {int} {gnutls_ocsp_req_get_cert_id} (gnutls_ocsp_req_const_t @var{req}, unsigned @var{indx}, gnutls_digest_algorithm_t * @var{digest}, gnutls_datum_t * @var{issuer_name_hash}, gnutls_datum_t * @var{issuer_key_hash}, gnutls_datum_t * @var{serial_number})
6@var{req}: should contain a @code{gnutls_ocsp_req_t}  type
7
8@var{indx}: Specifies which extension OID to get. Use (0) to get the first one.
9
10@var{digest}: output variable with @code{gnutls_digest_algorithm_t}  hash algorithm
11
12@var{issuer_name_hash}: output buffer with hash of issuer's DN
13
14@var{issuer_key_hash}: output buffer with hash of issuer's public key
15
16@var{serial_number}: output buffer with serial number of certificate to check
17
18This function will return the certificate information of the
19 @code{indx} 'ed request in the OCSP request.  The information returned
20corresponds to the CertID structure:
21
22<informalexample><programlisting>
23CertID	  ::=     SEQUENCE @{
24hashAlgorithm       AlgorithmIdentifier,
25issuerNameHash      OCTET STRING, -- Hash of Issuer's DN
26issuerKeyHash       OCTET STRING, -- Hash of Issuers public key
27serialNumber	CertificateSerialNumber @}
28</programlisting></informalexample>
29
30Each of the pointers to output variables may be NULL to indicate
31that the caller is not interested in that value.
32
33@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
34negative error code is returned.  If you have reached the last
35CertID available @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE}  will be
36returned.
37@end deftypefun
38