ChannelType 複合型

プロバイダーがイベントをログに記録できるチャネルを定義します。

<xs:complexType name="ChannelType"
    mixed="true"
>
    <xs:sequence>
        <xs:element name="logging"
            type="ChannelLoggingType"
            minOccurs="0"
         />
        <xs:element name="publishing"
            type="ChannelPublishingType"
            minOccurs="0"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="chid"
        type="token"
        use="optional"
     />
    <xs:attribute name="type"
        type="string"
        use="required"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="optional"
     />
    <xs:attribute name="access"
        type="string"
        use="optional"
     />
    <xs:attribute name="isolation"
        type="string"
        use="optional"
     />
    <xs:attribute name="enabled"
        type="boolean"
        default="false"
        use="optional"
     />
    <xs:attribute name="value"
        type="UInt8Type"
        use="optional"
     />
    <xs:attribute name="message"
        type="string"
        use="optional"
     />
</xs:complexType>

子要素

要素	Type	説明
ログ	ChannelLoggingType	チャネルをバックアップするログ ファイルのプロパティ (容量、ログ ファイルがシーケンシャルか循環かなど) を定義します。
公開	ChannelPublishingType	チャネルが使用するセッションのログ記録プロパティを定義します。 セッションのログ プロパティを指定できるのは、カスタム分離を使用するデバッグ チャネルと分析チャネルのみです。

属性

名前	型	説明
access	string	チャネルをサポートするログ ファイルへのアクセスを制御する セキュリティ記述子定義言語 (SDDL) アクセス記述子。 分離属性が Application または System に設定されている場合、アクセス記述子はファイルへの読み取りアクセスを制御します (書き込みアクセス許可は無視されます)。 分離属性が Custom に設定されている場合、アクセス記述子はチャネルへの書き込みアクセスとファイルへの読み取りアクセスを制御します。
chid	token	プロバイダーが定義またはインポートするチャネルの一覧でチャネルを一意に識別する識別子。 イベントでチャネルを参照する場合は、この値を使用します。 チャネル識別子を指定しない場合は、チャネルの名前を使用して、イベント定義でこのチャネルを参照します。
enabled	boolean	チャネルが有効かどうかを判断します。 チャネルへのログ記録を許可するには 、true に設定します。それ以外の場合は false。 既定値は false です (ログ記録は無効です)。 Debug チャネルと Analytic チャネルの種類は大量のチャネルであるため、そのチャネルに書き込むコンポーネントの問題を調査する場合にのみチャネルを有効にする必要があります。それ以外の場合は、チャネルを無効のままにする必要があります。 Debug and Analytic チャネルを有効にするたびに、サービスはチャネルからイベントをクリアします。
による分離	string	分離値は、チャネルの既定のアクセス許可を定義します。 次のいずれかの値を指定できます。 アプリケーション システム Custom 既定の分離は Application です。 アプリケーションの既定のアクセス許可は (SDDL を使用して表示されます) です。 Text L"O:BAG:SYD:" L"(A;;0xf0007;;;SY)" // local system (read, write, clear) L"(A;;0x7;;;BA)" // built-in admins (read, write, clear) L"(A;;0x7;;;SO)" // server operators (read, write, clear) L"(A;;0x3;;;IU)" // INTERACTIVE LOGON (read, write) L"(A;;0x3;;;SU)" // SERVICES LOGON (read, write) L"(A;;0x3;;;S-1-5-3)" // BATCH LOGON (read, write) L"(A;;0x3;;;S-1-5-33)" // write restricted service (read, write) L"(A;;0x1;;;S-1-5-32-573)"; // event log readers (read) System の既定のアクセス許可は (SDDL を使用して表示されます) です。 Text L"O:BAG:SYD:" L"(A;;0xf0007;;;SY)" // local system (read, write, clear) L"(A;;0x7;;;BA)" // built-in admins (read, write, clear) L"(A;;0x3;;;BO)" // backup operators (read, write) L"(A;;0x5;;;SO)" // server operators (read, clear) L"(A;;0x1;;;IU)" // INTERACTIVE LOGON (read) L"(A;;0x3;;;SU)" // SERVICES LOGON (read, write) L"(A;;0x1;;;S-1-5-3)" // BATCH LOGON (read) L"(A;;0x2;;;S-1-5-33)" // write restricted service (write) L"(A;;0x1;;;S-1-5-32-573)"; // event log readers (read) カスタム分離の既定のアクセス許可は、アプリケーションと同じです。 アプリケーションの分離を指定するチャネルでは、同じ ETW セッションが使用されます。 同じことが 、システム の分離にも当てはまります。 ただし、 カスタム 分離を指定すると、サービスによってチャネル用に個別の ETW セッションが作成されます。 カスタム分離を使用すると、チャネルとバッキング ファイルのアクセス許可を制御できます。 使用可能な ETW セッションは 64 個だけなので、 カスタム 分離の使用を制限する必要があります。
message	string	チャネルのローカライズされた表示名。 メッセージ文字列は、マニフェストの stringTable セクション内のローカライズされた文字列を参照します。
name	anyURI	チャネルの名前。 名前は、プロバイダーが使用するチャネルの一覧内で一意である必要があります。 チャネルの名前付けの規則は、プロバイダーの名前にチャネルの種類を追加することです。 次に例を示します。 プロバイダーの名前が Company-Product-Component で、運用チャネルを定義している場合、名前は Company-Product-Component/Operational になります。 チャネル名は 255 文字以下にする必要があり、'>'、'<'、'&'、'"、'|'、'\'、':'、''、'?'、'*'、またはコードが 31 未満の文字を含めることはできません。
記号	CSymbolType	アプリケーション内のチャネルを参照するために使用するシンボル。 メッセージ コンパイラ (MC.exe) は、 シンボルを使用して、コンパイラによって生成されるヘッダー ファイル内のチャネルの定数を作成します。 シンボルを指定しない場合、コンパイラによって名前が生成されます。
type	string	チャネルの種類を識別します。 次のいずれかの種類を指定できます。 管理者 運用時 分析 デバッグ 管理タイプ チャネルは、エンド ユーザー、管理者、およびサポート担当者を対象とするイベントをサポートします。 管理 チャネルに書き込まれるイベントには、管理者が操作できる明確に定義されたソリューションが必要です。管理者イベントの例としては、アプリケーションがプリンターへの接続に失敗したときに発生するイベントがあります。 これらのイベントは、適切に文書化されているか、問題を修正するために何を行う必要があるかを読者に直接指示するメッセージが関連付けられています。 操作の種類チャネルは、問題または発生の分析と診断に使用されるイベントをサポートします。 これらは、問題や現象に基づいてツールやタスクをトリガーするために使用できます。 運営用のイベントの例としては、システムに対してプリンターを追加または削除したときに発生するイベントがあります。 分析の種類のチャネルでは、大量に発行されたイベントがサポートされます。 これらは、プログラム操作を記述し、ユーザーの介入によって処理できない問題を示しています。 デバッグの種類チャネルは、デバッグの問題を診断するために開発者のみが使用するイベントをサポートします。 分析チャネルとデバッグ チャネルは既定で無効になっており、問題の原因を特定するためにのみ有効にする必要があります。 たとえば、チャネルを有効にし、問題の原因となっているシナリオを実行し、チャネルを無効にして、イベントのクエリを実行します。 チャネルを有効にすると、既存のイベントのチャネルがクリアされることに注意してください。 分析チャネルとデバッグ チャネルで循環バッキング ファイルが使用されている場合は、チャネルを無効にしてイベントのクエリを実行する必要があります。 すべての管理 チャネルで同じ ETW セッションが使用されます。運用チャネルについても同じことが当てはまります。 ただし、各分析チャネルとデバッグ チャネルでは、個別の ETW セッションが使用されます。これは、必要な場合にのみこれらのチャネルの種類を有効にするもう 1 つの理由です (使用可能な ETW セッションの数は限られています)。
value	UInt8Type	プロバイダーが定義するチャネルの一覧内のチャネルを一意に識別する数値識別子。 指定されていない場合、メッセージ コンパイラによって値が割り当てられます。

解説

チャネルの名前がチャネルの名前付け規則に従っている場合、Windows イベント ビューアーは円記号に続く文字列を使用してチャネルを一覧表示します。 たとえば、チャネル名が Company-Product-Component/Operational の場合、イベント ビューアーは Company-Product-Component プロバイダーの下にチャネルを Operational として一覧表示します。 それ以外の場合は、プロバイダーの下にチャネル名全体が表示されます。 ローカライズされた表示名は、指定された場合に使用されます。

要件

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

`