IDataManager::put_Rules method (pla.h)

Retrieves or sets the rules to apply to the report.

This property is read/write.

Syntax

HRESULT put_Rules(
  BSTR bstrXml
);

Parameters

bstrXml

Return value

None

Remarks

The rules modify the contents of the report after it is generated. To specify the content that TraceRpt generates, see IDataManager::ReportSchema.

The following schema defines the rules that you can specify. The Rules element is the root node. You can specify one or more Group elements, and each Group element can contain one or more Rule elements. The Help element is an optional user-defined element. The Step element defines a set of conditions and associated actions that are taken if the conditions are met.

<Rules>
    <Include name="" fatal="true|false"/>
    <Group name="" enabled="true|false">
        <Rule name="" enabled="true|false">
            <Help/>
            <Step/>
        </Rule>
    </Group>
</Rules>

<Step select="" fatal="true|false" sortType="first|max|min" sortValue="" sortDataType="">
    <UserInput/>
    <Exists>
        <When/>
        <Otherwise/>
    </Exists>
    <Otherwise/>
</Step>

<UserInput name="" expression="">
    <Description/>
</UserInput>

<When expression="" matchRE="">
    <Action/>
</When>
...
<Otherwise>
    <Action/>
</Otherwise>

<Variable name="" expression="">
</Variable>

<Warning name="">
</Warning>

<Notify type="" code="" severity="" title="">
</Notify>

<Insert select="">
    <Attribute name="" value=""/>
    <Node axis=""/>
</Insert>

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

IDataManager