3.2.4 Message Processing Events and Sequencing Rules

Calls made by the higher-layer protocol or application are passed directly to the transport. All return values from method invocations MUST be returned uninterpreted to the higher-layer protocol or application.

Methods in RPC Opnum Order

Method	Description
ElfrClearELFW	This method instructs the server to clear an event log and optionally, to back up the event log before the clear takes place. Opnum: 0
ElfrBackupELFW	This method instructs the server to back up the event log to a specified file name. Opnum: 1
ElfrCloseEL	This method instructs the server to close a handle to the event log, freeing resources on the server that maintained an association between the handle and the corresponding event log. This handle MUST have been obtained via the ElfrOpenELW (section 3.1.4.3) method, ElfrOpenELA (section 3.1.4.4) method, ElfrOpenBELW (section 3.1.4.1) method, or ElfrOpenBELA (section 3.1.4.2) method. Opnum: 2
ElfrDeregisterEventSource	This method instructs the server to close a handle to the event log, freeing resources on the server that maintained an association between the handle and the corresponding event log. This handle MUST have been obtained via the ElfrRegisterEventSourceW (section 3.1.4.5) method or the ElfrRegisterEventSourceA (section 3.1.4.6) method. Opnum: 3
ElfrNumberOfRecords	This method instructs the server to report the number of records currently in the event log. Opnum:4
ElfrOldestRecord	This method instructs the server to report the record number of the oldest record in the event log. Opnum: 5
ElfrChangeNotify	Reserved for local use. Notifies local processes about changes to the event log. Opnum: 6
ElfrOpenELW	This method instructs the server to return a handle to a live event log. For this to succeed, the caller has to have permission to read the file that contains the event log. The server has an access control list (ACL) that is used to control access to the log. The protocol does not have any methods for reading or setting that ACL. Opnum: 7
ElfrRegisterEventSourceW	This method instructs the server to return a handle to an event log for writing. For this to succeed, the caller MUST have permission to write to the file that contains the event log. The module name argument specifies the event source, which is used to determine the relevant event log, as specified below. Opnum: 8
ElfrOpenBELW	This method instructs the server to return a handle to a backup event log. For this to succeed, the caller MUST have permission to read the file that contains the backup event log. Opnum: 9
ElfrReadELW	This method reads events from the event log; the server transmits these events to the client and advances the reader's position in the event log associated with this handle. The strings in the returned event MUST be in [UNICODE]. Opnum: 10
ElfrReportEventW	This method writes events to the event log; the server receives these events from the client. Opnum: 11
ElfrClearELFA	This method instructs the server to clear an event log and optionally, to back up the event log before the clear takes place. Opnum: 12
ElfrBackupELFA	This method instructs the server to back up the event log to a specified file name. Opnum: 13
ElfrOpenELA	This method instructs the server to return a handle to a live event log. For this to succeed, the caller has to have permission to read the file that contains the event log. The server has an ACL that is used to control access to the log. The protocol does not have any methods for reading or setting that ACL. Opnum: 14
ElfrRegisterEventSourceA	This method instructs the server to return a handle to an event log for writing. For this to succeed, the caller MUST have permission to write to the file that contains the event log. The module name argument specifies the event source, which is used to determine the relevant event log, as specified in the following sections. Opnum: 15
ElfrOpenBELA	This method instructs the server to return a handle to a backup event log. For this to succeed, the caller MUST have permission to read the file that contains the backup event log. Opnum: 16
ElfrReadELA	This method reads events from the event log; the server transmits these events to the client and advances the reader's position in the event log associated with this handle. The strings in the returned events MUST be ANSI. Opnum: 17
ElfrReportEventA	This method writes events to the event log; the server receives these events from the client. Opnum: 18
Opnum19NotUsedOnWire	Reserved for local use. Opnum: 19
Opnum20NotUsedOnWire	Reserved for local use. Opnum: 20
Opnum21NotUsedOnWire	Reserved for local use. Opnum: 21
ElfrGetLogInformation	This method instructs the server to return information about an event log. Opnum: 22
Opnum23NotUsedOnWire	Reserved for local use. Opnum: 23
ElfrReportEventAndSourceW	This method<43> instructs the server to write an event to an event log. It differs from the other methods for writing an event by specifying the event source at the time of the write. The other methods for writing an event required the event source to be specified when the handle was opened for write. This method is intended for client applications that forward events, reading them from one event log and writing them to another. Such applications need to forward the events from multiple original event sources. Opnum: 24
ElfrReportEventExW	This method writes events to the event log; the server receives these events from the client. Opnum: 25
ElfrReportEventExA	This method writes events to the event log; the server receives these events from the client. Opnum: 26

In the preceding table, the phrase "Reserved for local use" means that the client MUST NOT send the opnum, and the server behavior is undefined because it does not affect interoperability.