IDataCollectorSet::put_Subdirectory method (pla.h)

Article
07/27/2022

Retrieves or sets a base subdirectory of the root path where the next instance of the data collector set will write its logs.

This property is read/write.

Syntax

HRESULT put_Subdirectory(
  BSTR folder
);

Parameters

folder

Return value

None

Remarks

The actual name of the subdirectory used can be different if you had previously specified formatting options in the IDataCollectorSet::SubdirectoryFormat property. The IDataCollectorSet::LatestOutputLocation property contains the actual folder name used.

If a location is not specified, files are written to the path specified in the IDataCollectorSet::RootPath property.

PLA creates the folders in the subdirectory path if they do not exist. Note that the folders will not inherit the ACLs from the root path. The user specified in the IDataCollectorSet::UserAccount property and those in the Administrators group will have read and write access to the folders. Users in the Performance Log Users group and Performance Monitor Users group have read-only access.

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