# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_init_creds_step - Get the next KDC request for acquiring initial credentials.

krb5_error_code krb5_init_creds_step(krb5_context context, krb5_init_creds_context ctx, krb5_data *in, krb5_data *out, krb5_data *realm, unsigned int *flags)

param:

  [in] context - Library context

  [in] ctx - Initial credentials context

  [in] in - KDC response (empty on the first call)

  [out] out - Next KDC request

  [out] realm - Realm for next KDC request

  [out] flags - Output flags

retval:

  - 0 Success; otherwise - Kerberos error codes

This function constructs the next KDC request in an initial credential exchange, allowing the caller to control the transport of KDC requests and replies. On the first call, in should be set to an empty buffer; on subsequent calls, it should be set to the KDC’s reply to the previous request.

If more requests are needed, flags will be set to #KRB5_INIT_CREDS_STEP_FLAG_CONTINUE and the next request will be placed in out . If no more requests are needed, flags will not contain #KRB5_INIT_CREDS_STEP_FLAG_CONTINUE and out will be empty.

If this function returns KRB5KRB_ERR_RESPONSE_TOO_BIG , the caller should transmit the next request using TCP rather than UDP. If this function returns any other error, the initial credential exchange has failed.

> context must be the same as the one passed to krb5_init_creds_init() for this initial credentials context.