en:docs:fapi:dosqverify

This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS

Note: This is legacy API call. It is recommended to use 32-bit equivalent

2021/09/17 04:47 · prokushev · 0 Comments
2021/08/20 03:18 · prokushev · 0 Comments

DosQVerify

This call returns the value of the verify flag.

Syntax

DosQVerify (VerifySetting)

Parameters

  • VerifySetting (PUSHORT) - output : Address of the verify mode for the process.
  • 00H - Verify mode is not active.
  • 01H - Verify mode is active.

Return Code

rc (USHORT) - return

Return code description is:

  • 0 NO_ERROR

Remarks

When verify is active, OS performs a verify operation each time it does a file write to assure proper data recording on the disk. Although disk recording errors are rare, this function has been provided for applications to verify the proper recording of critical data.

Example Code

C Binding

  #define INCL_DOSFILEMGR
 
  USHORT  rc = DosQVerify(VerifySetting);
 
  PUSHORT          VerifySetting; /* Verify setting (returned) */
 
  USHORT           rc;            /* return code */

MASM Binding

  EXTRN  DosQVerify:FAR
  INCL_DOSFILEMGR     EQU 1
 
  PUSH@  WORD    VerifySetting ;Verify setting (returned)
  CALL   DosQVerify

Returns WORD

Note