Edit

TaskType Complex Type

  • Article

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]