xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_cc_cache_match.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_cc_cache_match -  Find a credential cache with a specified client principal.
2==================================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_cc_cache_match(krb5_context context, krb5_principal client, krb5_ccache * cache_out)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **client** - Client principal
16
17	          **[out]** **cache_out** - Credential cache handle
18
19
20..
21
22
23:retval:
24         -   0   Success
25         -   KRB5_CC_NOTFOUND   None
26
27
28..
29
30
31
32
33
34
35
36Find a cache within the collection whose default principal is *client* . Use *krb5_cc_close* to close *ccache* when it is no longer needed.
37
38
39
40
41
42
43
44
45
46
47..
48
49
50
51
52.. note::
53
54	 New in 1.10
55
56
57