HaslContextnext

since: 0.1

const char*
hasl_context_next (
  HaslContext* ctx
)

Ask the context to move to the next possible mechanism.

If ctx is in a new or reset state via hasl_context_done(), it will build a list of mechanisms to attempt. It will prefer HaslContext:allowed-mechanisms over HaslContext:server-mechanisms, falling back to hasl_context_get_supported_mechanisms() if necessary.

The context will create an instance of the next mechanism to try which it will use internally and return the name that should be given to the server.

Available since: 0.1

Type: const char*

The name of the next mechanism to try or NULL if all mechanisms have been exhausted.

The returned data is owned by the instance.

The return value can be NULL.

The value is a NUL terminated UTF-8 string.