DosSetVerify (FAPI)

Description

This call sets the verify switch.

Syntax

 DosSetVerify

    (VerifySetting)

Parameters

VerifySetting (USHORT) - input

New state of Verify Mode for the requesting process as shown below:

   Value        Definition
    0        Verify mode is not active.
    1        Verify mode is active.

Return Code

rc (USHORT) - return

Return code descriptions are:

• 0 NO_ERROR
• 11 ERROR_INVALID_VERIFY_SWITCH

Remarks

When verify is active, OS/2 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 = DosSetVerify(VerifySetting);

USHORT           VerifySetting; /* New value of verify switch */

USHORT           rc;            /* return code */

MASM Binding

EXTRN  DosSetVerify:FAR
INCL_DOSFILEMGR     EQU 1

PUSH   WORD    VerifySetting ;New value of verify switch
CALL   DosSetVerify

Returns WORD