# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_get_init_creds_opt_alloc - Allocate a new initial credential options structure.

krb5_error_code `krb5_get_init_creds_opt_alloc`(krb5_context context, krb5_get_init_creds_opt ** opt)

param: | [in] context - Library context [out] opt - New options structure

retval: | 0 - Success; Kerberos errors otherwise.

This function is the preferred way to create an options structure for getting initial credentials, and is required to make use of certain options. Use `krb5_get_init_creds_opt_free()` to free opt when it is no longer needed.