NAME
   dce_svc_log_get - Reads the next record from a binary logfile

 SYNOPSIS

   #include <dce/dce.h>
   #include <pthread.h>
   #include <dce/svclog.h>

   void dce_svc_log_get( dce_svc_log_handle_t handle,
                         dce_svc_log_prolog_t *prolog,
                         error_status_t *status );

 PARAMETERS

   Input

   handle    The handle (returned by dce_svc_log_open()) of the logfile
             to be read.

   Output

   prolog    A pointer to a structure containing information read from
             the logfile record.

   status    Returns the status code from this operation. The status
             code is a value that indicates whether the routine
             completed successfully and if not, why not.

 DESCRIPTION

   The dce_svc_log_get() routine reads the next entry from a binary
   format serviceability log, and fills in prolog with a pointer to a
   private data area containing the data read.  The contents of the
   prolog structure are defined in dce/svclog.h.

 ERROR CODES

   See dce_svc_register.

 RELATED INFORMATION

   Functions: dce_svc_log_close
              dce_svc_log_open
              dce_svc_log_rewind