Undo method of the Control class

Restore the active configuration of the collector from the previous backup file (determined by going back from the current original timestamp). If the configuration has been just set, this means undoing that change. The consecutive calls will undo to the earlier and earlier configurations. Returns 1 on success, 0 on error.

Syntax

Uint32 Undo(
  [in]  Uint32 OldTimestampLow,
  [in]  Uint32 OldTimestampHigh,
  [out] Uint32 NewTimestampLow,
  [out] Uint32 NewTimestampHigh,
  [out] Uint32 OriginalTimestampLow,
  [out] Uint32 OriginalTimestampHigh,
  [out] string ErrorString,
  [out] string WarningString,
  [out] string InfoString,
  [out] uint32 ErrorType
);

Parameters

OldTimestampLow [in]

The timestamp of when the previous configuration was set. If not 0, enables the atomicity check: the new configuration will be applied only if the timestamp of the old configuration matches (i.e. the configuration was not changed in between). This is the low part of FILETIME.

OldTimestampHigh [in]

The timestamp of when the previous configuration was set. If not 0, enables the atomicity check: the new configuration will be applied only if the timestamp of the old configuration matches (i.e. the configuration was not changed in between). This is the high part of FILETIME.

NewTimestampLow [out]

The timestamp of when the new configuration was set, if the call succeeds. This is the low part of FILETIME.

NewTimestampHigh [out]

The timestamp of when the new configuration was set, if the call succeeds. This is the high part of FILETIME.

OriginalTimestampLow [out]

The original timestamp of when the restored configuration was set for the first time. This is the low part of FILETIME.

OriginalTimestampHigh [out]

The original timestamp of when the restored configuration was set for the first time. This is the high part of FILETIME.

ErrorString [out]

The text string with explanation of the error.

WarningString [out]

The text string with warnings.

InfoString [out]

The text string with information about the configuration.

ErrorType [out]

The type of the error: note that 0 or absent indicates success.

0

Success.

1

bad argument format

2

bad argument value

3

resource (socket) open error

4

persistence (file write) error

5

atomicity error (the old timestamp didn't match)

Return value

0

Failure

1

Success

Requirements

See also

Control