IDataCollector::put_FileName method (pla.h)
Retrieves or sets the base name of the file that will contain the data collector data.
This property is read/write.
Syntax
HRESULT put_FileName(
BSTR name
);
Parameters
name
Return value
None
Remarks
The actual file name used could be different if you specified formatting options in the IDataCollector::FileNameFormat property. The IDataCollector::LatestOutputLocation property contains the actual file name used.
Do not include the path in the file name; the IDataCollectorSet::RootPath and IDataCollectorSet::Subdirectory properties determine the path to the file.
The file name extension that you specify depends on the type of data collector. The following table shows the correct extension to use for each data collector. If you specify a different extension, PLA will use it. If you do not specify an extension, PLA adds the correct extension to the file.
| Data collector type | Extension to use |
|---|---|
| Configuration data collectors | .xml |
| Performance data collectors | Can be .blg, .csv, or .tsv depending on the value of the IPerformanceCounterDataCollector::LogFileFormat property. |
| Trace data collectors | .etl |
The IDataCollector::LogAppend and IDataCollector::LogOverwrite properties determine the action taken if the file already exists.
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 |