IDataCollectorSet::put_Segment method (pla.h)

Retrieves or sets a value that indicates whether PLA creates new logs if the maximum size or segment duration is reached before the data collector set is stopped.

This property is read/write.

Syntax

HRESULT put_Segment(
  VARIANT_BOOL segment
);

Parameters

segment

Return value

None

Remarks

You would enable segmentation, for example, if you want to write to a new log file when the current log file reaches 100 MB. The name used for the new log is determined by the IDataCollector::FileNameFormat property.

The task associated with the data collector set is launched each time a segment is created.

If VARIANT_TRUE, PLA uses both the IDataCollectorSet::SegmentMaxSize and IDataCollectorSet::SegmentMaxDuration properties, if set, to determine when to segment the log. When one of the limits is reached, PLA segments the log. After segmenting the log, PLA resets the counters for limits.

If VARIANT_FALSE, PLA ignores SegmentMaxSize and SegmentMaxDuration.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header pla.h
DLL Pla.dll

See also

IDataCollectorSet

IDataCollectorSet::SegmentMaxDuration

IDataCollectorSet::SegmentMaxSize