Jenis Kompleks EventDefinitionType

Menentukan peristiwa yang dapat ditulis penyedia Anda.

<xs:complexType name="EventDefinitionType">
    <xs:simpleContent>
        <xs:extension
            base="string"
        >
            <xs:attribute name="value"
                type="UInt32Type"
                use="required"
             />
            <xs:attribute name="level"
                type="QName"
                use="optional"
             />
            <xs:attribute name="template"
                type="token"
                use="optional"
             />
            <xs:attribute name="channel"
                type="token"
                use="optional"
             />
            <xs:attribute name="keywords"
                type="QNameList"
                use="optional"
             />
            <xs:attribute name="task"
                type="QName"
                use="optional"
             />
            <xs:attribute name="opcode"
                type="QName"
                use="optional"
             />
            <xs:attribute name="symbol"
                type="CSymbolType"
                use="optional"
             />
            <xs:attribute name="version"
                type="unsignedByte"
                use="optional"
             />
            <xs:attribute name="message"
                type="strTableRef"
                use="optional"
             />
            <xs:attribute name="notLogged"
                type="boolean"
                use="optional"
                default="false"
             />
        </xs:extension>
    </xs:simpleContent>
</xs:complexType>

Atribut

Nama	Jenis	Deskripsi
saluran	token	Pengidentifikasi yang mengidentifikasi saluran tempat peristiwa ditulis. Tentukan pengidentifikasi saluran dari salah satu saluran yang Anda tentukan atau impor. Jika saluran tidak menentukan pengidentifikasi saluran, gunakan nama saluran. Untuk detail tentang menentukan atau mengimpor saluran, lihat jenis kompleks ChannelListType . Jika Anda tidak menentukan saluran, acara tidak ditulis ke saluran. Biasanya, satu-satunya alasan untuk tidak menentukan saluran adalah jika Anda menulis peristiwa hanya ke sesi ETW. Untuk detailnya, lihat membuat sesi ETW, lihat Mengontrol Sesi Pelacakan Peristiwa.
kata kunci	QNameList	Daftar nama kata kunci yang dipisahkan spasi yang mengidentifikasi kategori peristiwa tempat peristiwa ini berada. Tentukan nama kata kunci dari daftar kata kunci yang Anda tentukan. Untuk detail tentang menentukan kata kunci, lihat jenis kompleks KeywordType . Jika Anda tidak menentukan kata kunci, deskriptor peristiwa akan berisi nol untuk kata kunci.
tingkat	QName	Tingkat verbositas yang digunakan saat menulis peristiwa. Tentukan nama tingkat yang Anda tentukan dalam manifes atau salah satu tingkat yang ditentukan dalam file \Include\Winmeta.xml yang disertakan dalam Windows SDK. Untuk detail tentang menentukan tingkat, lihat jenis kompleks LevelType . Jika Anda tidak menentukan tingkat, deskriptor peristiwa akan berisi nol untuk tingkat. Anda harus menentukan tingkat jika jenis saluran tempat peristiwa ditulis Admin; tingkat harus salah satu tingkat berikut yang ditentukan dalam Winmeata.xml: win:Critical win:Error win:Warning win:Informational
pesan	strTableRef	Pesan yang dilokalkan untuk peristiwa tersebut. String pesan mereferensikan string yang dilokalkan di bagian stringTable dari manifes. Anda harus menentukan pesan jika jenis saluran tempat peristiwa ditulis Admin.
notLogged	boolean	Menentukan apakah penyedia mencatat kejadian ini. Tentukan benar jika penyedia mencatat kejadian ini; jika tidak, salah. Gunakan atribut ini untuk menunjukkan bahwa penyedia tidak lagi mencatat peristiwa ini alih-alih menghapus peristiwa dari manifes. Mempertahankan peristiwa dalam manifes akan memungkinkan konsumen mendekode file etl lama yang menyertakan peristiwa tersebut. Windows Server 2008 dan Windows Vista: Atribut ini tidak didukung dalam versi pengkompilasi pesan yang dikirim sebelum Windows 7 versi Windows SDK.
Opcode	QName	Nama opcode yang mengidentifikasi operasi dalam tugas. Tentukan nama opcode yang Anda tentukan dalam manifes atau salah satu opcode yang ditentukan dalam Winmeta.xml. Untuk detail tentang mendefinisikan opcode, lihat jenis kompleks OpcodeType . Jika tugas yang Anda referensikan berisi opcode khusus tugas (lokal), Anda dapat menentukan salah satu opcode khusus tugas atau opcode yang ditentukan di tingkat penyedia (opcode global). Jika Anda menentukan opcode global, nilai opcode global tidak boleh sama dengan salah satu opcode lokal untuk tugas tersebut. Jika Anda mereferensikan opcode lokal, atribut tugas harus mereferensikan tugas tempat opcode lokal berada. Jika Anda tidak menentukan opcode, deskriptor peristiwa akan berisi nol untuk opcode.
simbol	CSymbolType	Simbol yang digunakan untuk mereferensikan deskriptor peristiwa untuk peristiwa ini di aplikasi Anda. Pengkompilasi Pesan (MC.exe) menggunakan simbol untuk membuat konstanta untuk pendeskripsi peristiwa dalam file header yang dihasilkan pengkompilasi. Jika Anda tidak menentukan simbol, pengkompilasi akan menghasilkannya untuk Anda. Anda menggunakan deskriptor saat memanggil fungsi EventWrite untuk menulis peristiwa.
tugas	QName	Nama tugas yang mengidentifikasi komponen atau subkomponen yang menghasilkan peristiwa ini. Tentukan nama tugas yang Anda tentukan dalam manifes. Untuk detail tentang menentukan tugas, lihat jenis kompleks TaskType . Jika Anda tidak menentukan tugas, deskriptor peristiwa akan berisi nol untuk tugas.
templat	token	Pengidentifikasi templat templat yang menentukan item data yang disertakan peristiwa ini. Tentukan pengidentifikasi templat yang Anda tentukan dalam manifes. Untuk detail tentang menentukan templat, lihat jenis kompleks TemplateItemType .
nilai	UInt32Type	Pengidentifikasi peristiwa. Pengidentifikasi harus unik dalam daftar peristiwa yang Anda tentukan.
versi	unsignedByte	Nomor versi satu byte dari definisi peristiwa.

Keterangan

Jika Anda menggunakan EvtFormatMessage untuk memformat string pesan untuk peristiwa (atau menggunakan Pemantau Peristiwa untuk melihat string pesan), string pesan dapat berisi string penyisipan dan salah satu string format yang didukung fungsi Win32 FormatMessage. String penyisipan terbatas pada %n atau %n!s! (misalnya, %1) di mana n adalah referensi berbasis-satu item data yang ditentukan dalam templat peristiwa. String pesan juga dapat berisi string penyisipan parameter dalam formulir %%n (misalnya, %%4). Jumlah maksimum string penyisipan yang dapat dimuat pesan adalah 100.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]