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.