Edit

Share via

SetConfiguration method of the Control class

  • Article

Set the new active configuration of the collector.

Syntax

Uint32 SetConfiguration(
  [in]  string Config,
  [in]  Uint32 OldTimestampLow,
  [in]  Uint32 OldTimestampHigh,
  [out] Uint32 NewTimestampLow,
  [out] Uint32 NewTimestampHigh,
  [out] string ErrorString,
  [out] string WarningString,
  [out] string InfoString,
  [out] uint32 ErrorType
);

Parameters

Config [in]

The configuration to activate.

OldTimestampLow [in]

The low-order bits of a timestamp that indicates when the current active configuration was set. Atomicity checking is enabled if this property is not set to 0.

OldTimestampHigh [in]

The high-order bits of a timestamp that indicates when the current active configuration was set. Atomicity checking is enabled if this property is not set to 0.

NewTimestampLow [out]

When this method returns, this parameter contains the low-order bits of a timestamp that indicates when the new configuration was set. Atomicity checking is enabled if this property is not set to 0.

NewTimestampHigh [out]

When this method returns, this parameter contains the high-order bits of the timestamp that indicates when the new configuration was set. Atomicity checking is enabled if this property is not set to 0.

ErrorString [out]

When this method returns, if there was an error, this parameter contains the error description.

WarningString [out]

When this method returns, this parameter contains any warnings messages for the operation.

InfoString [out]

When this method returns, this parameter contains information for the new active configuration.

ErrorType [out]

When this method returns, if there was an error, this parameter indicates the error type.

0

The new configuration is missing.

1

The format of the new configuration is invalid.

2

The new configuration is invalid.

3

There was an error caused by an open socket.

4

There was a file write error.

5

There was an atomicity error.

Return value

0

Failure

1

Success

Requirements

Requirement Value
Minimum supported client
 Windows 10 [desktop apps only]
Minimum supported server
 Windows Server 2016
Namespace
 Root\Microsoft\Windows\BootEventCollector
MOF
BootEventCollectorWMI.mof
DLL
BEvtCol.exe

See also

Control