xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_cccol_cursor_next.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_cccol_cursor_next -  Get the next credential cache in the collection.
2===========================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_cccol_cursor_next(krb5_context context, krb5_cccol_cursor cursor, krb5_ccache * ccache)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **cursor** - Cursor
16
17	          **[out]** **ccache** - Credential cache handle
18
19
20..
21
22
23:retval:
24         -   0   Success; otherwise - Kerberos error codes
25
26
27..
28
29
30
31
32
33
34
35Use krb5_cc_close() to close *ccache* when it is no longer needed.
36
37
38
39
40
41
42
43
44
45
46..
47
48.. seealso::
49         krb5_cccol_cursor_new(), krb5_cccol_cursor_free()
50
51
52
53
54
55
56.. note::
57
58	 When all caches are iterated over and the end of the list is reached, *ccache* is set to NULL.
59
60
61
62
63