Edit

Share via

ITraceDataCollector::get_ExtendedModes method (pla.h)

  • Article

Retrieves or sets the extended log file modes.

This property is read/write.

Syntax

HRESULT get_ExtendedModes(
  unsigned long *mode
);

Parameters

mode

Return value

None

Remarks

Use this property to set the following log file modes:

  • EVENT_TRACE_PRIVATE_IN_PROC
  • EVENT_TRACE_USE_GLOBAL_SEQUENCE
  • EVENT_TRACE_USE_LOCAL_SEQUENCE
  • EVENT_TRACE_USE_PAGED_MEMORY
For a description of all log file modes and their values, see Logging Mode Constants. To set the other available log file modes, set the corresponding PLA property as shown in the following table.
Log file mode Corresponding PLA property
EVENT_TRACE_BUFFERING_MODE ITraceDataProvider::StreamMode is set to plaBuffering.
EVENT_TRACE_FILE_MODE_APPEND IDataCollector::LogAppend.
EVENT_TRACE_FILE_MODE_CIRCULAR IDataCollector::LogCircular.
EVENT_TRACE_FILE_MODE_NEWFILE IDataCollectorSet::Segment and IDataCollectorSet::SegmentMaxSize.
EVENT_TRACE_FILE_MODE_PREALLOCATE ITraceDataCollector::PreallocateFile and IDataCollectorSet::SegmentMaxSize.
EVENT_TRACE_FILE_MODE_SEQUENTIAL IDataCollector::LogAppend and IDataCollector::LogCircular are false.
EVENT_TRACE_PRIVATE_LOGGER_MODE ITraceDataProvider::ProcessMode.
EVENT_TRACE_REAL_TIME_MODE ITraceDataProvider::StreamMode is set to plaRealTime.

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

ITraceDataCollector