# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_init_creds_init - Create a context for acquiring initial credentials.

krb5_error_code krb5_init_creds_init(krb5_context context, krb5_principal client, krb5_prompter_fct prompter, void *data, krb5_deltat start_time, krb5_get_init_creds_opt *options, krb5_init_creds_context *ctx)

param

  [in] context - Library context

  [in] client - Client principal to get initial creds for

  [in] prompter - Prompter callback

  [in] data - Prompter callback argument

  [in] start_time - Time when credentials become valid (0 for now)

  [in] options - Options structure (NULL for default)

  [out] ctx - New initial credentials context

retval

  - 0 Success; otherwise - Kerberos error codes

This function creates a new context for acquiring initial credentials. Use `krb5_init_creds_free()` to free ctx when it is no longer needed.

Any subsequent calls to `krb5_init_creds_step()` , `krb5_init_creds_get()` , or `krb5_init_creds_free()` for this initial credentials context must use the same context argument as the one passed to this function.