次の方法で共有


ProviderType 複合型

プロバイダーとそのイベントを定義するために使用するメタデータを定義します。

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

子要素

要素 Type 説明
channels ChannelListType プロバイダーがイベントをログに記録できるチャネルの一覧を定義します。
イベント DefinitionType プロバイダーがログに記録できるイベントのイベント定義の一覧を定義します。
フィルター FilterListType プロバイダーがサポートするフィルターの一覧を定義します。 フィルターは、レベルやキーワードと同様に使用して、イベントを記述するかどうかを判断できます。
Windows Server 2008 と Windows Vista: Windows 7 までサポートされていません。
キーワード KeywordListType イベントを分類するキーワードの一覧を定義します。
レベル LevelListType イベントの重大度を指定するレベルの一覧を定義します。
マップ MapType マニフェストのテンプレート セクションで参照できる名前と値のペアの一覧を定義します。
namedQueries NamedQueryType 使用されていません。 イベント メッセージ文字列に対して値のクエリを実行し、見つかった場合に指定したアクションを実行する名前付きクエリの一覧を定義します。
オペコード OpcodeListType タスク内のイベントをグループ化するために使用できるオペコードの一覧を定義します。
タスク TaskListType プロバイダーがイベントをグループ化するために使用できるタスクの一覧を定義します。 通常、タスクを使用して、プロバイダーの機能またはコンポーネントのイベントをグループ化します。
テンプレート TemplateListType イベントに含めるデータを指定するテンプレートの一覧を定義します。

属性

名前 Type 説明
guid GUIDType プロバイダーを一意に識別する GUID。
Helplink anyURI URL または MS ヘルプは、プロバイダーが発生させるイベントに関する情報を提供するコンテンツにリンクします。
message strTableRef プロバイダーのローカライズされた表示名。 メッセージ文字列は、マニフェストの stringTable セクション内のローカライズされた文字列を参照します。
messageFileName filePath プロバイダーのローカライズされたメッセージ リソースを含むファイルへの完全なパス。 ファイルには、実行可能ファイルまたは DLL ファイルを指定できます。
name anyURI プロバイダーの名前。 名前は、 会社-の製品-コンポーネントという形式にする必要があります。
名前は 255 文字を超えることはできません。また、''、'>'、'<'、''、'&"、'|'、'\'、':'、''、'?'、'*'、またはコードが 31 未満の文字を含めることはできません。 さらに、名前は、ファイルとレジストリ キーの名前に関する一般的な制約に従う必要があります。 これらの制約は、「ファイルの 名前付け」および 「レジストリ要素のサイズ制限」で確認できます。
parameterFileName filePath プロバイダーのパラメーター文字列リソースを含むファイルへの完全パス。 ファイルには、実行可能ファイルまたは DLL ファイルを指定できます。 複数のパラメーター ファイルをセミコロンで区切って指定できます。 イベントのメッセージ文字列にパラメーター文字列が含まれている場合、ファイルが検索されます。 パラメーターを使用すると、ローカライズ可能な挿入文字列を提供できます。 詳細については、「解説」を参照してください。
resourceFileName filePath プロバイダーのメタデータ リソースを含むファイルへの完全なパス。 ファイルには、実行可能ファイルまたは DLL ファイルを指定できます。
source 内部使用専用です。
記号 CSymbolType アプリケーションでプロバイダーの GUID を参照するために使用するシンボル。 メッセージ コンパイラ (MC.exe) は、 シンボルを使用して、コンパイラによって生成されるヘッダー ファイル内のプロバイダーの GUID の定数を作成します。
warnOnApplicationCompatibilityError xs:boolean 内部使用専用です。

解説

Windows イベント ビューアー (Eventvwr.exe) は、ローカライズされたメッセージ文字列 (使用可能な場合) を使用します。それ以外の場合は、name 属性の文字列を使用します。

resourceFileName、messageFileName、および parameterFileName のパスには、環境変数を含めることができます。 パスで使用する新しい環境変数を定義する場合は、イベント ログ サービスが新しい変数を取得できるように、コンピューターを再起動する必要があります。そうしないと、サービスはプロバイダーのリソースを見つけることができません。

イベントのメッセージ文字列には、挿入文字列とパラメーター文字列を含めることができます。 挿入文字列の形式は %n です。 n は、メッセージに挿入するイベントのデータ テンプレートのデータ項目を識別する 1 から始まるインデックスです。 パラメーター文字列 ( parameterFileName 属性を参照) は %%n という形式で、n はメッセージ テーブル内のメッセージの識別子です。 イベントのメッセージ文字列に "%1 %%11 = %2 %%12" が含まれており、%1 と %2 のデータ項目値がそれぞれ 8 と 2 で、%%11 と %%12 のパラメーター文字列が "quarts" と "ガロン" である場合、書式設定された文字列はそれぞれ "8 quarts = 2 ガロン" になります。

必要条件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2008 [デスクトップ アプリのみ]