ProviderType 複合型

[アーティクル]
06/13/2023

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

<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 [デスクトップアプリのみ]

ProviderType 複合型

子要素

属性

解説

必要条件

フィードバック

フィードバック

その他のリソース