IDataCollectorSet::put_Subdirectory method (pla.h)

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

See also

IDataCollectorSet

IDataCollectorSet::LatestOutputLocation

IDataCollectorSet::OutputLocation

IDataCollectorSet::RootPath

IDataCollectorSet::SubdirectoryFormat

IDataCollectorSet::SubdirectoryFormatPattern