Partilhar via


Tipo complexo TaskType

Define um componente ou subcomponente de um aplicativo.

<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>

Elementos filho

Elemento Type Descrição
Opcodes OpcodeListType Define uma lista de opcodes específicos da tarefa. Você não pode usar os valores opcode definidos em Winmeta.xml para opcodes específicos da tarefa.

Atributos

Nome Tipo Descrição
eventGUID GUIDType Um identificador global exclusivo, no formato registro, que identifica a tarefa. Esse atributo será necessário se você usar o argumento do compilador de mensagens -mof para gerar uma classe MOF para suporte de nível inferior.
message strTableRef O nome de exibição localizado para a tarefa. A cadeia de caracteres de mensagem faz referência a uma cadeia de caracteres localizada na seção stringTable do manifesto.
name QName O nome da tarefa.
símbolo CSymbolType O símbolo a ser usado para referenciar a tarefa em seu aplicativo. O Compilador de Mensagens (MC.exe) usa o símbolo para criar uma constante para a tarefa no arquivo de cabeçalho gerado pelo compilador. Se você não especificar um símbolo, o compilador gerará um para você.
value UInt16Type Um valor numérico que identifica exclusivamente essa tarefa na lista de tarefas que o provedor define. O valor deve estar no intervalo de 1 a 239.

Exemplos

O exemplo a seguir mostra como especificar uma tarefa.

<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>

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]