service (ULONG) - input

      The class of Logging Service:

    • Error Logging
    • Event Tracing

      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.

      You provide an entry-key data structure. Entry keys are generated by this function and by LogWaitEvent. Log file searching typically begins at the entry that follows the one specified within the event key. The event key is updated as new entries are read.

      If no event filter is provided, LogReadEntry will read the entry that is pointed to by the event key. You also have the option of starting a search at the logical beginning of the Log File.

      For Event Tracing, this is a pointer to a LREREQUESTTRACE structure.

      You provide an entry ID. Log File searching typically begins at the entry that follows the one that is specified by the event ID. The event ID is updated as entries are read.

      If no event filter is provided, LogReadEntry will read the entry that is pointed to by the entry ID. You also have 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 
          ERROR_LF_BUF_TOO_SMALL
        
          ERROR_LF_INVALID_SERVICE
        
          ERROR_LF_GENERAL_FAILURE
        
          INVALID_DATA_POINTER
        
          INVALID_LF_LOG_FILE_ID
        
          INVALID_LF_PACKET_REVISION_NUMBER
        
          INVALID_DATA_PAINTER
        
          INVALID_LF_PARM_PACKET_PTR
        
          ERROR_LF_AT_END_OF_LOG
        
          INVALID_LF_FLAG
        
          ERROR_LF_ENTRY_KEY
        
          ERROR_LF_INVALID_PACKET_SIZE
        
          INVALID_LF_FLAG


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