Tipo Complexo ProviderType

  • Artigo

Define um provedor e os metadados que ele usa para definir seus eventos.

<xs:complexType name="ProviderType">
    <xs:choice
        minOccurs="0"
        maxOccurs="unbounded"
    >
        <xs:element name="channels"
            type="ChannelListType"
         />
        <xs:element name="levels"
            type="LevelListType"
         />
        <xs:element name="tasks"
            type="TaskListType"
         />
        <xs:element name="opcodes"
            type="OpcodeListType"
         />
        <xs:element name="keywords"
            type="KeywordListType"
         />
        <xs:element name="maps"
            type="MapType"
         />
        <xs:element name="namedQueries"
            type="NamedQueryType"
         />
        <xs:element name="templates"
            type="TemplateListType"
         />
        <xs:element name="events"
            type="DefinitionType"
         />
        <xs:element name="filters"
            type="FilterListType"
         />
        <xs:any
            processContents="lax"
            namespace="##other"
         />
    </xs:choice>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="guid"
        type="GUIDType"
        use="required"
     />
    <xs:attribute name="resourceFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="messageFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="parameterFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="helpLink"
        type="anyURI"
        use="optional"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="required"
     />
    <xs:attribute name="message"
        type="strTableRef"
        use="optional"
     />
    <xs:attribute name="source"
        use="optional"
        default="Xml"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="Xml"
                 />
                <xs:enumeration
                    value="Wbem"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="warnOnApplicationCompatibilityError"
        type="xs:boolean"
        use="optional"
        default="false"
     />
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

Elementos filho

Elemento Type Descrição
canais ChannelListType Define uma lista de canais para os quais os provedores podem registrar eventos.
Eventos DefinitionType Define uma lista de definições de evento dos eventos que o provedor pode registrar.
Filtros FilterListType Define uma lista de filtros compatíveis com o provedor. Você pode usar os filtros, como faria em nível e palavras-chave, para determinar se deseja escrever um evento.
Windows Server 2008 e Windows Vista: Não há suporte até o Windows 7.
Keywords KeywordListType Define uma lista de palavras-chave que categorizam eventos.
Níveis LevelListType Define uma lista de níveis que especificam a gravidade de um evento.
Mapas MapType Define uma lista de pares nome/valor que você pode referenciar na seção de modelo do manifesto.
namedQueries NamedQueryType Não usado. Define uma lista de consultas nomeadas que consultam a cadeia de caracteres de mensagem de evento para um valor e executam uma ação especificada, se encontrada.
Opcodes OpcodeListType Define uma lista de opcodes que você pode usar para agrupar eventos em uma tarefa.
Tarefas TaskListType Define uma lista de tarefas que um provedor pode usar para agrupar eventos. Normalmente, você usa tarefas para agrupar eventos para um recurso ou componente do provedor.
Modelos TemplateListType Define uma lista de modelos que especificam os dados a serem incluídos com os eventos.

Atributos

Nome Tipo Descrição
guid GUIDType Um GUID que identifica exclusivamente o provedor.
Helplink anyURI A URL ou a MS ajudam a vincular ao conteúdo que fornece informações sobre os eventos gerados pelo provedor.
message strTableRef O nome de exibição localizado para o provedor. A cadeia de caracteres de mensagem faz referência a uma cadeia de caracteres localizada na seção stringTable do manifesto.
messageFileName filePath O caminho completo para o arquivo que contém os recursos de mensagem localizados do provedor. O arquivo pode ser um arquivo executável ou um arquivo DLL.
name anyURI O nome do provedor. O nome deve ser do formulário,Componente doProduto-da Empresa-.
O nome não pode ter mais de 255 caracteres e não pode conter os caracteres: '>', '<', '&', '"', '|', '\', ':', '', '?', '*' ou caracteres com códigos menores que 31. Além disso, o nome deve seguir as restrições gerais em nomes de chave de arquivo e registro. Essas restrições podem ser encontradas em Nomeando um arquivo e limites de tamanho de elemento do Registro.
parameterFileName filePath O caminho completo para o arquivo que contém os recursos de cadeia de caracteres de parâmetro do provedor. O arquivo pode ser um arquivo executável ou um arquivo DLL. Você pode especificar mais de um arquivo de parâmetro separado por ponto e vírgula. O arquivo é pesquisado quando a cadeia de caracteres de mensagem de um evento contém uma cadeia de caracteres de parâmetro. Os parâmetros permitem que você forneça cadeias de caracteres de inserção localizáveis. Confira Comentários para obter mais informações.
Resourcefilename Filepath O caminho completo para o arquivo que contém os recursos de metadados do provedor. O arquivo pode ser um arquivo executável ou um arquivo DLL.
source Apenas para uso interno.
símbolo CSymbolType O símbolo a ser usado para fazer referência ao GUID do provedor em seu aplicativo. O Compilador de Mensagens (MC.exe) usa o símbolo para criar uma constante para o GUID do provedor no arquivo de cabeçalho gerado pelo compilador.
warnOnApplicationCompatibilityError xs:boolean Apenas para uso interno.

Comentários

O Visualizador de Eventos do Windows (Eventvwr.exe) usará a cadeia de caracteres de mensagem localizada se disponível; caso contrário, ele usará a cadeia de caracteres do atributo name.

Os caminhos para resourceFileName, messageFileName e parameterFileName podem conter variáveis de ambiente. Se você definir uma nova variável de ambiente a ser usada no caminho, será necessário reiniciar o computador para que o serviço de log de eventos possa pegar a nova variável; caso contrário, o serviço não poderá localizar os recursos do provedor.

A cadeia de caracteres de mensagem de um evento pode conter cadeias de caracteres de inserção e cadeias de caracteres de parâmetro. Uma cadeia de caracteres de inserção é do formulário %n, em que n é um índice baseado em um que identifica um item de dados do modelo de dados do evento que você deseja inserir na mensagem. Uma cadeia de caracteres de parâmetro (consulte o atributo parameterFileName ) é do formulário %%n, em que n é o identificador de uma mensagem na tabela de mensagens. Se a cadeia de caracteres de mensagem do evento contivesse "%1 %%11 = %2 %12" e os valores do item de dados para %1 e %2 fossem 8 e 2, respectivamente, e as cadeias de caracteres de parâmetro para %%11 e %%12 fossem "quarts" e "galões", respectivamente, a cadeia de caracteres formatada seria "8 quarts = 2 galões".

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]