DosLogRead

From EDM2
Jump to: navigation, search

This function is part of the 16-Bit Error Logging APIs for IBM OS/2 Version 2.1.

Syntax

DosLogRead (LogHandle, Length, LogBuffer, ReadSize)

Parameters

LogHandle (USHORT)
is the named pipe handle returned by DosLogRegister()
Length (USHORT)
is the length (in words) of the caller's log buffer
LogBuffer (PVOID)
is the address of the caller's buffer, into which the system Error Logging facility will place a single Error Log entry packet (formatted in the manner of the 16 bit DosLogEntry API).
ReadSize (PUSHORT)
is the address of a word, into which the system Error Logging facility will place the number of bytes that it wrote into the caller's log buffer. If a zero is returned here, then there was no Error Log packet to return.

Return Code

APIRET16 APIENTRY16

DosLogRead returns the following values:

  • indicating Success. : non-zero
  • indicating error : 0

Possible reasons for failure:

  • Invalid log handle
  • Facility unavailable
  • Buffer too small

Remarks

In order to resolve successfully DosLogRead function calls in your program, the following lines must be added to the Linker Definition (DEF) file:

IMPORTS
DOSLOGREAD=DOSCALL1.196

DosLogRead returns Error Log entries that are formatted in the manner of the 16-bit DosLogEntry API.