drivers: regulator: add API to read error flags

Add a new API to obtain the active error flags on a regulator, e.g.
overcurrent, overvoltage or over temperature.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>