xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_cc_next_cred.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_cc_next_cred -  Retrieve the next entry from the credential cache.
2========================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_cc_next_cred(krb5_context context, krb5_ccache cache, krb5_cc_cursor * cursor, krb5_creds * creds)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **cache** - Credential cache handle
16
17	          **[in]** **cursor** - Cursor
18
19	          **[out]** **creds** - Next credential cache entry
20
21
22..
23
24
25:retval:
26         -   0   Success; otherwise - Kerberos error codes
27
28
29..
30
31
32
33
34
35
36
37This function fills in *creds* with the next entry in *cache* and advances *cursor* .
38
39
40
41Use krb5_free_cred_contents() to free *creds* when it is no longer needed.
42
43
44
45
46
47
48
49
50
51
52..
53
54.. seealso::
55         krb5_cc_start_seq_get(), krb5_end_seq_get()
56
57
58
59
60
61