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

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

Attributes

Name	Type	Description
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.
name	QName	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

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