normalize


Description:

[ Version ( since = "1.0" ) ]
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, hashed by str_hash and str_equal functions. 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