1=pod
2
3=head1 NAME
4
5X509_STORE_CTX_get_by_subject,
6X509_STORE_CTX_get_obj_by_subject
7- X509 and X509_CRL lookup functions
8
9=head1 SYNOPSIS
10
11 #include <openssl/x509_vfy.h>
12
13 int X509_STORE_CTX_get_by_subject(const X509_STORE_CTX *vs,
14                                   X509_LOOKUP_TYPE type,
15                                   const X509_NAME *name, X509_OBJECT *ret);
16 X509_OBJECT *X509_STORE_CTX_get_obj_by_subject(X509_STORE_CTX *vs,
17                                                X509_LOOKUP_TYPE type,
18                                                const X509_NAME *name);
19
20=head1 DESCRIPTION
21
22X509_STORE_CTX_get_by_subject() tries to find an object
23of given I<type>, which may be B<X509_LU_X509> or B<X509_LU_CRL>,
24and subject I<name> from the store in the provided store context I<vs>.
25If found and I<ret> is not NULL, it increments the reference count and
26stores the looked up object in I<ret>.
27
28X509_STORE_CTX_get_obj_by_subject() is like X509_STORE_CTX_get_by_subject()
29but returns the found object on success, else NULL.
30
31=head1 RETURN VALUES
32
33X509_STORE_CTX_get_by_subject() returns 1 if the lookup was successful, else 0.
34
35X509_STORE_CTX_get_obj_by_subject() returns an object on success, else NULL.
36
37=head1 SEE ALSO
38
39L<X509_LOOKUP_meth_set_get_by_subject(3)>,
40L<X509_LOOKUP_by_subject(3)>
41
42=head1 COPYRIGHT
43
44Copyright 2022 The OpenSSL Project Authors. All Rights Reserved.
45
46Licensed under the Apache License 2.0 (the "License").  You may not use
47this file except in compliance with the License.  You can obtain a copy
48in the file LICENSE in the source distribution or at
49L<https://www.openssl.org/source/license.html>.
50
51=cut
52