ChannelType 複雜類型

發行項
06/13/2023

定義提供者可記錄事件的通道。

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

子元素

元素	類型	描述
測井	ChannelLoggingType	定義記錄檔的屬性，以備份通道，例如其容量，以及記錄檔是循序還是迴圈的。
出版	ChannelPublishingType	定義通道所使用的會話記錄屬性。只有使用自訂隔離的偵錯和分析通道和通道可以為其會話指定記錄屬性。

屬性

名称類型描述

access string 安全性描述元定義語言 (SDDL) 存取描述元，可控制通道之記錄檔的存取權。如果隔離屬性設定為 Application 或 System，存取描述元會控制對檔案的讀取權限， (忽略寫入權限) 。如果隔離屬性設定為 Custom，存取描述元會控制通道的寫入權限，以及檔案的讀取權限。

chid token 識別碼，可唯一識別提供者定義或匯入之通道清單中的通道。在事件中參考通道時，請使用此值。如果您未指定通道識別碼，請使用通道的名稱在事件定義中參考此通道。

已啟用 boolean 判斷通道是否已啟用。設定為 true 以允許記錄到通道;否則為 false。預設值為 false (記錄會停用) 。
因為偵錯和分析通道類型是大量通道，所以只有在調查寫入該通道的元件問題時，才應該啟用通道;否則，通道應該保持停用狀態。
每次啟用偵錯和分析通道時，服務都會清除通道中的事件。

隔離

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)

系統會使用 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 會話。使用自訂隔離可讓您控制通道和支援檔案的存取權限。因為只有 64 個 ETW 會話可用，所以您應該限制使用自訂隔離。

message

字串

通道的當地語系化顯示名稱。訊息字串會參考資訊清單之 stringTable 區段中的當地語系化字串。

NAME

anyURI

通道的名稱。名稱在提供者使用的通道清單中必須是唯一的。命名通道的慣例是將通道類型附加至提供者的名稱。例如，如果提供者的名稱是 Company-Product-Component，而且您定義操作通道，則名稱會是 Company-Product-Component/Operational。

通道名稱必須少於 255 個字元，且不能包含下列字元：'>'、'<'、'&'、''、'|'、'\'、'：'、'？'、'*'或代碼小於 31 的字元。

符號

CSymbolType

用來參考應用程式中通道的符號。 訊息編譯器 (MC.exe) 會使用符號，為編譯器產生的標頭檔中的通道建立常數。如果您未指定符號，編譯器就會為您產生名稱。

type

字串

識別通道的類型。您可以指定下列其中一種類型：

管理員
作業
分析
偵錯

管理員類型通道支援以使用者、系統管理員和支援人員為目標的事件。寫入至管理員通道的事件應該具有定義完善的解決方案，讓系統管理員可以採取行動。系統管理事件的範例是應用程式無法連線到印表機時所發生的事件。這些事件是妥善記載的，或有與其相關聯的訊息，可讓讀者直接指示解決問題。

操作類型通道支援用來分析及診斷問題或發生的事件。根據問題或發生的情況，它們可以用來觸發工具或工作。舉例而言，在系統中新增或移除印表機時所發生的事件，就是作業事件。

分析類型通道支援大量發佈的事件。它們會描述程式作業，並指出使用者操作所無法處理的問題。

偵錯類型通道支援僅由開發人員用來診斷問題以進行偵錯的事件。

預設會停用分析和偵錯通道，而且應該只啟用以判斷問題的原因。例如，您可以啟用通道、執行造成問題的案例、停用通道，然後查詢事件。請注意，啟用通道會清除現有事件的通道。如果分析和偵錯通道使用迴圈備份檔案，您必須停用通道來查詢其事件。

所有管理員通道都使用相同的 ETW 會話;作業通道也是如此。不過，每個分析和偵錯通道都會使用不同的 ETW 會話，這是只在需要時啟用這些通道類型的另一個原因， (有有限的 ETW 會話可用) 。

value

UInt8Type

數值識別碼，可唯一識別提供者所定義通道清單中的通道。如果未指定，訊息編譯器會指派值。

備註

如果通道的名稱遵循通道命名慣例，Windows 事件檢視器會使用反斜線後面的字串來列出通道。例如，如果通道名稱為 Company-Product-Component/Operational，則事件檢視器會將通道列為 Company-Product-Component 提供者下的 Operational。否則，整個通道名稱會顯示在提供者下方。如果提供，則會使用當地語系化的顯示名稱。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]

共用方式為

ChannelType 複雜類型

子元素

屬性

備註

規格需求

意見反應

其他資源