LogReadEntry - Parameters

service (ULONG) - input

The class of Logging Service:
• Error Logging

  All other values are reserved for future use.

pReadEntry (PVOID) - in/out

A pointer to the LogReadEntry parameter packet.

For Error Logging, this is a pointer to a LREREQUEST structure.

The caller can specify a filter that is used to select only entries of a desired class. The format of the filter is the same as the filter that is described in the LogOpenEventNotification API pFilter parameter. The caller also provides an entry key data structure. Entry keys are generated by this API and by the LogWaitEvent API.

Log File searching typically begins at the entry that follows the one that is specified within the event key. The event key is updated as new entries are read. If no event filter is provided, the LogReadEntry API will read the entry that is pointed to by the event key. The caller also has the option of starting a search at the logical beginning of the Log File.

rc (APIRET) - returns

Return code.

LogReadEntry returns the following values:

• No error 
  520 Error LF buf too small
  
  523 Error LF invalid service
  
  524 Error LF general failure
  
  1703 Invalid data pointer
  
  1701 Invalid LF log file id
  
  1702 Invalid LF packet revision number
  
  1706 Invalid LF parm packet ptr
  
  1750 Invalid LF at end of log
  
  1751 Invalid LF flag
  
  1759 Invalid LF entry key
  
  1761 Error LF invalid packet size

  ---

  [Back: LogReadEntry Return Value - rc]
  [Next: LogReadEntry - Remarks]