TaskType Complex Type

Defines a component or subcomponent of an application.

<xs:complexType name="TaskType"
    mixed="true"
>
    <xs:sequence>
        <xs:element name="opcodes"
            type="OpcodeListType"
            minOccurs="0"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="QName"
        use="required"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="optional"
     />
    <xs:attribute name="value"
        type="UInt16Type"
        use="required"
     />
    <xs:attribute name="eventGUID"
        type="GUIDType"
        use="optional"
     />
    <xs:attribute name="message"
        type="strTableRef"
        use="optional"
     />
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

Child elements

ElementTypeDescription
opcodes OpcodeListType

Defines a list of task-specific opcodes. You cannot use the opcode values defined in Winmeta.xml for task-specific opcodes.

Attributes

NameTypeDescription
eventGUID GUIDType

A globally unique identifier, in Registry format, that identifies the task. This attribute is required if you use the -mof message compiler argument to generate a MOF class for downlevel support.

message strTableRef

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

nameQName

The name of the task.

symbol CSymbolType

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

value UInt16Type

A numeric value that uniquely identifies this task within the list of tasks that the provider defines. The value must be in the range from 1 through 239.

Examples

The following example shows how to specify a task.


<tasks>
  <task name="printspool:Disconnect" 
         symbol="PRINTSPOOL_TASK_DISCONNECT"
         value="0" 
         message="$(string.disconnect)"/>
 
  <task name="printspool:Connect" 
         symbol="PRINTSPOOL_TASK_CONNECT"
         value="1" 
         message="$(string.connect)">
       <opcodes>
          <opcode name="ReadRegistry" 
                  symbol="MYOPCODE_READ_REGISTRY" value="11"
                  message="$(string.ReadRegistry)"/>
       </opcodes>
   </task>
</tasks>

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

 

 

Community Additions

ADD
Show:
© 2014 Microsoft