KeywordType Complex Type

Defines a keyword that identifies a category of events. A keyword is a tag that you attach to an event to group events based on their usage.

<xs:complexType name="KeywordType"
    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="mask"
                type="HexInt64Type"
                use="required"
             />
            <xs:attribute name="message"
                type="strTableRef"
                use="optional"
             />
            <xs:anyAttribute
                processContents="lax"
                namespace="##other"
             />
        </xs:extension>
    </xs:simpleContent>
</xs:complexType>

Attributes

NameTypeDescription
mask HexInt64Type

A bitmask that must have only a single bit set. The bit represents a category of events (for example, read events or write events). You can specify bit values in the range from 0x0000000000000001 through 0x0000800000000000 (bits 0 through 47).

message strTableRef

The localized display name for the keyword. The message string references a localized string in the stringTable section of the manifest.

nameQName

The name of the keyword. The name must be unique within the list of keywords that the provider defines.

symbol CSymbolType

The symbol to use to reference the keyword in your application. The Message Compiler (MC.exe) uses the symbol to create a constant for the keyword in the header file that the compiler generates. If you do not specify a symbol, the compiler generates one for you.

Remarks

The Winmeta.xml file that is included in the Windows SDK contains a list of keywords. These keywords are reserved and should not be used.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

 

 

Show: