krb5_get_krbhst()--Get List of KDC Hosts

 #include <krb5.h>

 krb5_error_code krb5_get_krbhst(
     krb5_context     context,
     krb5_const krb5_data *   realm,   
     char ***       hostlist);   

The krb5_get_krbhst() function returns a list of Kerberos Key Distribution Center (KDC) server hosts for a Kerberos realm. The list is obtained from the [realms] section of the Kerberos configuration file.

Authorities

No authorities are required.

Parameters

context  (Input)

The Kerberos context.

realm  (Input)

The Kerberos realm.

hostlist  (Output)

The KDC host list. The last entry in the list is a NULL pointer. The krb5_free_krbhst() routine should be called to release the host list when it is no longer needed.

Return Value

If no errors occur, the return value is 0. Otherwise, a Kerberos error code is returned.

Error Messages