Tipo complejo ProviderType

  • Artículo

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]