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