Tipo Complexo ProviderType

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]