en:docs:fapi:dossetverify

This is an old revision of the document!


DosSetVerify

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

<PRE> #define INCL_DOSFILEMGR

USHORT rc = DosSetVerify(VerifySetting);

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

USHORT rc; /* return code */ </PRE>

MASM Binding

<PRE> EXTRN DosSetVerify:FAR INCL_DOSFILEMGR EQU 1

PUSH WORD VerifySetting ;New value of verify switch CALL DosSetVerify

Returns WORD </PRE>

Note