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 |
---|---|
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 |
|
This method instructs the server to back up the event log to a specified file name. Opnum: 1 |
|
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 |
|
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 |
|
This method instructs the server to report the number of records currently in the event log. Opnum:4 |
|
This method instructs the server to report the record number of the oldest record in the event log. Opnum: 5 |
|
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 |
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 |
|
This method writes events to the event log; the server receives these events from the client. Opnum: 11 |
|
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 |
|
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 |
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 |
|
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 |
This method instructs the server to return information about an event log. Opnum: 22 |
|
Opnum23NotUsedOnWire |
Reserved for local use. Opnum: 23 |
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 |
|
This method writes events to the event log; the server receives these events from the client. Opnum: 25 |
|
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.