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(3dce)
.

RELATED INFORMATION

Functions: dce_svc_log_close(3dce), dce_svc_log_open(3dce), dce_svc_log_rewind(3dce).