Tipo complejo ProviderType

Define un proveedor y los metadatos que usa para definir sus 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 secundarios

Elemento	Tipo	Descripción
canales nueva	ChannelListType	Define una lista de canales a los que los proveedores pueden registrar eventos.
Eventos	DefinitionType	Define una lista de definiciones de eventos de los eventos que el proveedor puede registrar.
Filtros	FilterListType	Define una lista de filtros que admite el proveedor. Puede usar los filtros, como haría en el nivel y las palabras clave, para determinar si desea escribir un evento. Windows Server 2008 y Windows Vista: No se admite hasta Windows 7.
Palabras clave	KeywordListType	Define una lista de palabras clave que clasifican eventos.
Niveles	LevelListType	Define una lista de niveles que especifican la gravedad de un evento.
Mapas	MapType	Define una lista de pares nombre-valor a los que puede hacer referencia en la sección de plantilla del manifiesto.
namedQueries	NamedQueryType	No se usa. Define una lista de consultas con nombre que consultan la cadena del mensaje de evento para un valor y realizan una acción especificada si se encuentra.
Opcodes	OpcodeListType	Define una lista de códigos de operación que puede usar para agrupar eventos dentro de una tarea.
Tareas	TaskListType	Define una lista de tareas que un proveedor puede usar para agrupar eventos. Normalmente, se usan tareas para agrupar eventos para una característica o componente del proveedor.
Plantillas	TemplateListType	Define una lista de plantillas que especifican los datos que se van a incluir con los eventos.

Atributos

Nombre	Tipo	Descripción
guid	GUIDType	GUID que identifica de forma única el proveedor.
helpLink	anyURI	La dirección URL o ms ayudan a vincular al contenido que proporciona información sobre los eventos que genera el proveedor.
message	strTableRef	Nombre para mostrar localizado para el proveedor. La cadena de mensaje hace referencia a una cadena localizada en la sección stringTable del manifiesto.
messageFileName	Filepath	Ruta de acceso completa al archivo que contiene los recursos de mensaje localizados del proveedor. El archivo puede ser un archivo ejecutable o un archivo DLL.
name	anyURI	Nombre del proveedor. El nombre debe tener el formatoComponente de producto de-empresa-. El nombre no puede tener más de 255 caracteres y no puede contener los caracteres: '', '><', '&', '', '|', '\', ':', '', '?', '*' o caracteres con códigos inferiores a 31. Además, el nombre debe seguir las restricciones generales en los nombres de clave de archivo y registro. Estas restricciones se pueden encontrar en Nomenclatura de un archivo y Límites de tamaño de elemento del Registro.
parameterFileName	Filepath	Ruta de acceso completa al archivo que contiene los recursos de cadena de parámetros del proveedor. El archivo puede ser un archivo ejecutable o un archivo DLL. Puede especificar más de un archivo de parámetros separados por un punto y coma. El archivo se busca cuando la cadena de mensaje de un evento contiene una cadena de parámetro. Los parámetros permiten proporcionar cadenas de inserción localizables. Vea Comentarios para obtener más información.
resourceFileName	Filepath	Ruta de acceso completa al archivo que contiene los recursos de metadatos del proveedor. El archivo puede ser un archivo ejecutable o un archivo DLL.
source		Solo para uso interno.
símbolo	CSymbolType	Símbolo que se va a usar para hacer referencia al GUID del proveedor en la aplicación. El compilador de mensajes (MC.exe) usa el símbolo para crear una constante para el GUID del proveedor en el archivo de encabezado que genera el compilador.
warnOnApplicationCompatibilityError	xs:boolean	Solo para uso interno.

Comentarios

El Visor de eventos de Windows (Eventvwr.exe) usará la cadena de mensaje localizada si está disponible; de lo contrario, usa la cadena del atributo name.

Las rutas de acceso para resourceFileName, messageFileName y parameterFileName pueden contener variables de entorno. Si define una nueva variable de entorno que se va a usar en la ruta de acceso, debe reiniciar el equipo para que el servicio de registro de eventos pueda seleccionar la nueva variable; de lo contrario, el servicio no podrá encontrar los recursos del proveedor.

La cadena de mensaje de un evento puede contener cadenas de inserción y cadenas de parámetros. Una cadena de inserción tiene el formato %n, donde n es un índice basado en uno que identifica un elemento de datos de la plantilla de datos del evento que desea insertar en el mensaje. Una cadena de parámetro (vea el atributo parameterFileName ) tiene el formato %%n, donde n es el identificador de un mensaje en la tabla de mensajes. Si la cadena de mensaje del evento contenía "%1 %%11 = %2 %%12" y los valores del elemento de datos para %1 y %2 eran 8 y 2, respectivamente, y las cadenas de parámetros de %%11 y %%12 eran "quarts" y "galones", respectivamente, la cadena con formato sería "8 quarts = 2 galones".

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]