doc/html/_sources/appdev/refs/api/krb5_cc_next_cred.rst.txt

   1 krb5_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
  37 This function fills in *creds* with the next entry in *cache* and advances *cursor* .
  38
  39
  40
  41 Use :c:func:`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          :c:func:`krb5_cc_start_seq_get()` , krb5_end_seq_get()
  56
  57
  58
  59
  60