need_secrets
Description:
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 |
Returns:
the setting name of the Setting object which has invalid or missing secrets |