[MS-EVEN6]:
EventLog Remoting Protocol Version 6.0
Intellectual Property Rights Notice for Open Specifications Documentation
§ Technical Documentation. Microsoft publishes Open Specifications documentation (“this documentation”) for protocols, file formats, data portability, computer languages, and standards support. Additionally, overview documents cover inter-protocol relationships and interactions.
§ Copyrights. This documentation is covered by Microsoft copyrights. Regardless of any other terms that are contained in the terms of use for the Microsoft website that hosts this documentation, you can make copies of it in order to develop implementations of the technologies that are described in this documentation and can distribute portions of it in your implementations that use these technologies or in your documentation as necessary to properly document the implementation. You can also distribute in your implementation, with or without modification, any schemas, IDLs, or code samples that are included in the documentation. This permission also applies to any documents that are referenced in the Open Specifications documentation.
§ No Trade Secrets. Microsoft does not claim any trade secret rights in this documentation.
§ Patents. Microsoft has patents that might cover your implementations of the technologies described in the Open Specifications documentation. Neither this notice nor Microsoft's delivery of this documentation grants any licenses under those patents or any other Microsoft patents. However, a given Open Specifications document might be covered by the Microsoft Open Specifications Promise or the Microsoft Community Promise. If you would prefer a written license, or if the technologies described in this documentation are not covered by the Open Specifications Promise or Community Promise, as applicable, patent licenses are available by contacting .
§ License Programs. To see all of the protocols in scope under a specific license program and the associated patents, visit the Patent Map.
§ Trademarks. The names of companies and products contained in this documentation might be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit www.microsoft.com/trademarks.
§ Fictitious Names. The example companies, organizations, products, domain names, email addresses, logos, people, places, and events that are depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred.
Reservation of Rights. All other rights are reserved, and this notice does not grant any rights other than as specifically described above, whether by implication, estoppel, or otherwise.
Tools. The Open Specifications documentation does not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments, you are free to take advantage of them. Certain Open Specifications documents are intended for use in conjunction with publicly available standards specifications and network programming art and, as such, assume that the reader either is familiar with the aforementioned material or has immediate access to it.
Support. For questions and support, please contact .
Revision Summary
Date / Revision History / Revision Class / Comments /10/22/2006 / 0.01 / New / Version 0.01 release
1/19/2007 / 1.0 / Major / Version 1.0 release
3/2/2007 / 1.1 / Minor / Version 1.1 release
4/3/2007 / 1.2 / Minor / Version 1.2 release
5/11/2007 / 1.3 / Minor / Version 1.3 release
6/1/2007 / 2.0 / Major / Updated and revised the technical content.
7/3/2007 / 2.0.1 / Editorial / Changed language and formatting in the technical content.
7/20/2007 / 2.0.2 / Editorial / Changed language and formatting in the technical content.
8/10/2007 / 2.1 / Minor / Clarified the meaning of the technical content.
9/28/2007 / 2.2 / Minor / Clarified the meaning of the technical content.
10/23/2007 / 3.0 / Major / Added clarification of server state.
11/30/2007 / 4.0 / Major / Updated and revised the technical content.
1/25/2008 / 5.0 / Major / Updated and revised the technical content.
3/14/2008 / 6.0 / Major / Updated and revised the technical content.
5/16/2008 / 6.0.1 / Editorial / Changed language and formatting in the technical content.
6/20/2008 / 6.1 / Minor / Clarified the meaning of the technical content.
7/25/2008 / 6.2 / Minor / Clarified the meaning of the technical content.
8/29/2008 / 6.3 / Minor / Removed constants in IDL.
10/24/2008 / 6.3.1 / Editorial / Changed language and formatting in the technical content.
12/5/2008 / 7.0 / Major / Updated and revised the technical content.
1/16/2009 / 7.0.1 / Editorial / Changed language and formatting in the technical content.
2/27/2009 / 7.0.2 / Editorial / Changed language and formatting in the technical content.
4/10/2009 / 7.0.3 / Editorial / Changed language and formatting in the technical content.
5/22/2009 / 7.1 / Minor / Clarified the meaning of the technical content.
7/2/2009 / 7.1.1 / Editorial / Changed language and formatting in the technical content.
8/14/2009 / 7.2 / Minor / Clarified the meaning of the technical content.
9/25/2009 / 7.3 / Minor / Clarified the meaning of the technical content.
11/6/2009 / 8.0 / Major / Updated and revised the technical content.
12/18/2009 / 9.0 / Major / Updated and revised the technical content.
1/29/2010 / 9.1 / Minor / Clarified the meaning of the technical content.
3/12/2010 / 9.2 / Minor / Clarified the meaning of the technical content.
4/23/2010 / 9.3 / Minor / Clarified the meaning of the technical content.
6/4/2010 / 9.4 / Minor / Clarified the meaning of the technical content.
7/16/2010 / 10.0 / Major / Updated and revised the technical content.
8/27/2010 / 10.1 / Minor / Clarified the meaning of the technical content.
10/8/2010 / 10.1 / None / No changes to the meaning, language, or formatting of the technical content.
11/19/2010 / 11.0 / Major / Updated and revised the technical content.
1/7/2011 / 12.0 / Major / Updated and revised the technical content.
2/11/2011 / 13.0 / Major / Updated and revised the technical content.
3/25/2011 / 14.0 / Major / Updated and revised the technical content.
5/6/2011 / 15.0 / Major / Updated and revised the technical content.
6/17/2011 / 15.1 / Minor / Clarified the meaning of the technical content.
9/23/2011 / 15.1 / None / No changes to the meaning, language, or formatting of the technical content.
12/16/2011 / 16.0 / Major / Updated and revised the technical content.
3/30/2012 / 16.0 / None / No changes to the meaning, language, or formatting of the technical content.
7/12/2012 / 16.0 / None / No changes to the meaning, language, or formatting of the technical content.
10/25/2012 / 16.0 / None / No changes to the meaning, language, or formatting of the technical content.
1/31/2013 / 16.0 / None / No changes to the meaning, language, or formatting of the technical content.
8/8/2013 / 17.0 / Major / Updated and revised the technical content.
11/14/2013 / 18.0 / Major / Updated and revised the technical content.
2/13/2014 / 18.0 / None / No changes to the meaning, language, or formatting of the technical content.
5/15/2014 / 18.0 / None / No changes to the meaning, language, or formatting of the technical content.
6/30/2015 / 19.0 / Major / Significantly changed the technical content.
10/16/2015 / 19.0 / None / No changes to the meaning, language, or formatting of the technical content.
7/14/2016 / 19.0 / None / No changes to the meaning, language, or formatting of the technical content.
6/1/2017 / 19.0 / None / No changes to the meaning, language, or formatting of the technical content.
9/15/2017 / 20.0 / Major / Significantly changed the technical content.
Table of Contents
1 Introduction 8
1.1 Glossary 8
1.2 References 10
1.2.1 Normative References 10
1.2.2 Informative References 11
1.3 Overview 12
1.3.1 Background 12
1.3.2 EventLog Remoting Protocol Version 6.0 13
1.4 Relationship to Other Protocols 13
1.5 Prerequisites/Preconditions 14
1.6 Applicability Statement 14
1.7 Versioning and Capability Negotiation 14
1.8 Vendor-Extensible Fields 14
1.8.1 Channel Names 14
1.8.2 Publisher Names 15
1.8.3 Event Descriptor 15
1.8.4 Error Codes 15
1.9 Standards Assignments 15
2 Messages 16
2.1 Transport 16
2.1.1 Server 16
2.1.2 Client 16
2.2 Common Data Types 16
2.2.1 RpcInfo 16
2.2.2 BooleanArray 16
2.2.3 UInt32Array 17
2.2.4 UInt64Array 17
2.2.5 StringArray 17
2.2.6 GuidArray 18
2.2.7 EvtRpcVariant 18
2.2.8 EvtRpcVariantType 19
2.2.9 EvtRpcVariantList 19
2.2.10 EvtRpcAssertConfigFlags Enumeration 20
2.2.11 EvtRpcQueryChannelInfo 20
2.2.12 BinXml 20
2.2.12.1 Emitting Instruction for the Element Rule 25
2.2.12.2 Emitting Instruction for the Attribute Rule 25
2.2.12.3 Emitting Instruction for the Substitution Rule 26
2.2.12.4 Emitting Instruction for the CharRef Rule 27
2.2.12.5 Emitting Instruction for the EntityRef Rule 27
2.2.12.6 Emitting Instruction for the CDATA Section Rule 27
2.2.12.7 Emitting Instruction for the PITarget Rule 27
2.2.12.8 Emitting Instruction for the PIData Rule 27
2.2.12.9 Emitting Instruction for the CloseStartElement Token Rule 27
2.2.12.10 Emitting Instruction for the CloseEmptyElement Token Rule 27
2.2.12.11 Emitting Instruction for the EndElement Token Rule 27
2.2.12.12 Emitting Instruction for the TemplateInstanceData Rule 27
2.2.13 Event 28
2.2.14 Bookmark 31
2.2.15 Filter 32
2.2.15.1 Filter XPath 1.0 Subset 32
2.2.15.2 Filter XPath 1.0 Extensions 34
2.2.16 Query 35
2.2.17 Result Set 37
2.2.18 BinXmlVariant Structure 39
2.2.19 error_status_t 39
2.2.20 Handles 39
2.2.21 Binding Handle 40
2.3 Message Syntax 40
2.3.1 Common Values 40
3 Protocol Details 42
3.1 Server Details 42
3.1.1 Abstract Data Model 42
3.1.1.1 Events 42
3.1.1.2 Publishers 42
3.1.1.3 Publisher Tables 43
3.1.1.4 Channels 44
3.1.1.5 Channel Table 46
3.1.1.6 Logs 46
3.1.1.7 Localized Logs 47
3.1.1.8 Queries 49
3.1.1.9 Subscriptions 49
3.1.1.10 Control Object 49
3.1.1.11 Context Handles 49
3.1.1.12 Handle Table 52
3.1.1.13 Localized String Table 53
3.1.1.14 Publisher Resource, Message, and Parameter Files 53
3.1.2 Timers 55
3.1.3 Initialization 55
3.1.4 Message Processing Events and Sequencing Rules 55
3.1.4.1 Subscription Sequencing 57
3.1.4.2 Query Sequencing 58
3.1.4.3 Log Information Sequencing 58
3.1.4.4 Publisher Metadata Sequencing 58
3.1.4.5 Event Metadata Enumerator Sequencing 58
3.1.4.6 Cancellation Sequencing 59
3.1.4.6.1 Canceling Subscriptions 59
3.1.4.6.2 Canceling Queries 59
3.1.4.6.3 Canceling Clear or Export Methods 59
3.1.4.7 BinXml 59
3.1.4.7.1 BinXml Templates 60
3.1.4.7.2 Optional Substitutions 61
3.1.4.7.3 Type System 62
3.1.4.7.4 BinXml Type 63
3.1.4.7.5 Array Types 64
3.1.4.7.6 Prescriptive Details 65
3.1.4.8 EvtRpcRegisterRemoteSubscription (Opnum 0) 65
3.1.4.9 EvtRpcRemoteSubscriptionNextAsync (Opnum 1) 69
3.1.4.10 EvtRpcRemoteSubscriptionNext (Opnum 2) 70
3.1.4.11 EvtRpcRemoteSubscriptionWaitAsync (Opnum 3) 72
3.1.4.12 EvtRpcRegisterLogQuery (Opnum 5) 73
3.1.4.13 EvtRpcQueryNext (Opnum 11) 76
3.1.4.14 EvtRpcQuerySeek (Opnum 12) 78
3.1.4.15 EvtRpcGetLogFileInfo (Opnum 18) 80
3.1.4.16 EvtRpcClearLog (Opnum 6) 82
3.1.4.17 EvtRpcExportLog (Opnum 7) 83
3.1.4.18 EvtRpcLocalizeExportLog (Opnum 8) 86
3.1.4.19 EvtRpcOpenLogHandle (Opnum 17) 88
3.1.4.20 EvtRpcGetChannelList (Opnum 19) 89
3.1.4.21 EvtRpcGetChannelConfig (Opnum 20) 90
3.1.4.22 EvtRpcPutChannelConfig (Opnum 21) 94
3.1.4.23 EvtRpcGetPublisherList(Opnum 22) 99
3.1.4.24 EvtRpcGetPublisherListForChannel (Opnum 23) 100
3.1.4.25 EvtRpcGetPublisherMetadata (Opnum 24) 101
3.1.4.26 EvtRpcGetPublisherResourceMetadata (Opnum 25) 103
3.1.4.27 EvtRpcGetEventMetadataEnum (Opnum 26) 105
3.1.4.28 EvtRpcGetNextEventMetadata (Opnum 27) 106
3.1.4.29 EvtRpcAssertConfig (Opnum 15) 108
3.1.4.30 EvtRpcRetractConfig (Opnum 16) 110
3.1.4.31 EvtRpcMessageRender (Opnum 9) 111
3.1.4.32 EvtRpcMessageRenderDefault (Opnum 10) 115
3.1.4.33 EvtRpcClose (Opnum 13) 116
3.1.4.34 EvtRpcCancel (Opnum 14) 117
3.1.4.35 EvtRpcRegisterControllableOperation (Opnum 4) 117
3.1.4.36 EvtRpcGetClassicLogDisplayName (Opnum 28) 118
3.1.5 Timer Events 120
3.1.6 Other Local Events 120
3.2 Client Details 120
3.2.1 Abstract Data Model 120
3.2.2 Timers 120
3.2.3 Initialization 120
3.2.4 Message Processing Events and Sequencing Rules 120
3.2.5 Timer Events 120
3.2.6 Other Local Events 120
3.2.7 Changing Publisher Configuration Data 120
4 Protocol Examples 121
4.1 Query Example 121
4.2 Get Log Information Example 122
4.3 Bookmark Example 123
4.4 Simple BinXml Example 124
4.5 Structured Query Example 125
4.6 Push Subscription Example 126
4.7 Pull Subscription Example 127
4.8 BinXml Example Using Templates 129
4.9 Render Localized Event Message Example 133
4.10 Get Publisher List Example 135
4.11 Get Channel List Example 136
4.12 Get Event Metadata Example 136
4.13 Publisher Table and Channel Table Example 140
4.14 Backup and Archive the Event Log Example 141
5 Security 143
5.1 Security Considerations for Implementers 143
5.2 Index of Security Parameters 143
6 Appendix A: Full IDL 144
7 Appendix B: Product Behavior 150
8 Change Tracking 156
9 Index 157
1 Introduction
The EventLog Remoting Protocol Version 6.0, originally available in the Windows Vista operating system, is a remote procedure call (RPC)–based protocol that exposes RPC methods for reading events in both live event logs and backup event logs on remote computers. This protocol also specifies how to get general information for a log, such as number of records in the log, oldest records in the log, and if the log is full. It may also be used for clearing and backing up both types of event logs.
Sections 1.5, 1.8, 1.9, 2, and 3 of this specification are normative. All other sections and examples in this specification are informative.
1.1 Glossary
This document uses the following terms:
backup event log: An event log that cannot be written to, only read from. Backup event logs are typically used for archival purposes, or for copying to another computer for use by support personnel.
channel: A destination of event writes and a source for event reads. The physical backing store is a live event log.
cursor: The current position within a result set.
endpoint: A network-specific address of a remote procedure call (RPC) server process for remote procedure calls. The actual name and type of the endpoint depends on the RPC protocol sequence that is being used. For example, for RPC over TCP (RPC Protocol Sequence ncacn_ip_tcp), an endpoint might be TCP port 1025. For RPC over Server Message Block (RPC Protocol Sequence ncacn_np), an endpoint might be the name of a named pipe. For more information, see [C706].
event: A discrete unit of historical data that an application exposes that may be relevant to other applications. An example of an event would be a particular user logging on to the computer.
event descriptor: A structure indicating the kind of event. For example, a user logging on to the computer could be one kind of event, while a user logging off would be another, and these events could be indicated by using distinct event descriptors.