need_secrets

Description:

public unowned string need_secrets (out GenericArray<unowned string> hints)

Returns the name of the first setting object in the connection which would need secrets to make a successful connection.

The returned hints are only intended as a guide to what secrets may be required, because in some circumstances, there is no way to conclusively determine exactly which secrets are needed.

Parameters:

this	the Connection
hints	the address of a pointer to a GenericArray, initialized to `null`, which on return points to an allocated GenericArray containing the property names of secrets of the Setting which may be required; the caller owns the array and must free the array itself with `g_ptr_array_free`, but not free its elements

Returns:

the setting name of the Setting object which has invalid or missing secrets