normalize

Description:

public bool normalize (HashTable<string,void*>? parameters, out bool modified) throws Error

Does some basic normalization and fixup of well known inconsistencies and deprecated fields.

If the connection was modified in any way, the output parameter modified is set true.

Finally the connection will be verified and true returns if the connection is valid. As this function only performs some specific normalization steps it cannot repair all connections. If the connection has errors that cannot be normalized, the connection will not be modified.

Parameters:

this	the Connection to normalize
parameters	a GenericSet with normalization parameters to allow customization of the normalization by providing specific arguments. Unknown arguments will be ignored and the default will be used. The keys must be strings compared with str_equal function. The values are opaque and depend on the parameter name.
modified	outputs whether any settings were modified.

Returns:

true if the connection is valid, false if it is not