Edit

Share via

LevelType Complex Type

  • Article

Defines a severity value that determines the verbosity of the events being logged.

<xs:complexType name="LevelType"
    mixed="true"
>
    <xs:simpleContent>
        <xs:extension
            base="xs:string"
        >
            <xs:attribute name="name"
                type="QName"
                use="required"
             />
            <xs:attribute name="symbol"
                type="CSymbolType"
                use="optional"
             />
            <xs:attribute name="value"
                type="UInt8Type"
                use="required"
             />
            <xs:attribute name="message"
                type="strTableRef"
                use="optional"
             />
        </xs:extension>
    </xs:simpleContent>
</xs:complexType>

Attributes

Name Type Description
message strTableRef The localized display name for the level. The message string references a localized string in the stringTable section of the manifest.
name QName The name to assign to this level. This name must be unique within the scope of the provider.
symbol CSymbolType The symbol to use to reference the level in your application. The Message Compiler (MC.exe) uses the symbol to create a constant for the level in the header file that the compiler generates. If you do not specify a symbol, the compiler generates one for you.
value UInt8Type The level value. You can specify values in the range 16 to 255. For predefined level values, see Remarks.

Remarks

The following are the predefined level values that you can use. These values are defined in the Winmeta.xml file that is included in the Windows SDK.

Name Value Symbol Description
win:Critical 1 WINEVENT_LEVEL_CRITICAL Identifies an abnormal exit or termination event.
win:Error 2 WINEVENT_LEVEL_ERROR Identifies a severe error event.
win:Warning 3 WINEVENT_LEVEL_WARNING Identifies a warning event such as an allocation failure.
win:Informational 4 WINEVENT_LEVEL_INFO Identifies a non-error event such as an entry or exit event.
win:Verbose 5 WINEVENT_LEVEL_VERBOSE Identifies a detailed trace event.

Higher numbers imply that you get lower levels as well. For example, if you specify win:Warning, you receive all warning, error, and critical events.

Requirements

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2008 [desktop apps only]