IDataCollector::get_FileNameFormatPattern method (pla.h)

Retrieves or sets the format pattern to use when decorating the file name.

This property is read/write.

Syntax

HRESULT get_FileNameFormatPattern(
  BSTR *pattern
);

Parameters

pattern

Return value

None

Remarks

PLA uses the pattern only if the IDataCollector::FileNameFormat property is set to plaPattern.

PLA appends the decoration to the file name. Use the following pattern characters to define your own pattern. For example, the pattern "MMMM d, yyyy \a\t h:mmTt" could yield "January 31, 2005 at 4:20AM". If the file name is MyFile, the decorated file name would be "MyFile January 31, 2005 at 4:20AM".

Pattern Description
D Day of the year.
DDD Day of the year with leading zeros, if applicable.
d Day of the month.
dd Day of the month with a leading zero, if applicable.
ddd The abbreviated name of the weekday, for example, Tue for Tuesday.
dddd Full name of the weekday.
M Month.
MM Month with leading zero, if applicable.
MMM The abbreviated name of the month, for example, Jan for January.
MMMM Full name of the month.
y Year without the century.
yy Year without the century but including a leading zero, if applicable.
yyyy Year with the century.
h Hour in a 12-hour clock.
hh Hour in a 12-hour clock with a leading zero, if applicable.
H Hour in a 24-hour clock.
HH Hour in a 24-hour clock with a leading zero, if applicable.
m Minute.
mm Minute with a leading zero, if applicable.
S Second.
Ss Second with a leading zero, if applicable.
T The first character of the A.M./P.M. designator.
Tt The A.M./P.M. designator.
Z Time zone offset.
Zz Time zone offset with a leading zero, if applicable.
N Serial number. The number of leading zeros is defined by the number of characters. For example, if the serial number is 32 and the pattern is NNN, the serial number used is 032.
\c Escaped character, where c is any character. Unrecognized characters, excluding white space, that are not escaped will result in an error.

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

IDataCollector

IDataCollector::FileName

IDataCollector::FileNameFormat