Jump to content

DosSetVerify (FAPI): Difference between revisions

From EDM2
Ak120 (talk | contribs)
mNo edit summary
Ak120 (talk | contribs)
mNo edit summary
 
(One intermediate revision by one other user not shown)
Line 6: Line 6:
==Parameters==
==Parameters==
;VerifySetting (USHORT) - input : New state of Verify Mode for the requesting process as shown below:
;VerifySetting (USHORT) - input : New state of Verify Mode for the requesting process as shown below:
'''Value        Definition'''
::0 - Verify mode is not active.
  0       Verify mode is not active.
::1 - Verify mode is active.
  1       Verify mode is active.


==Return Code==
==Return Code==
rc (USHORT) - return
;rc (USHORT) - return:Return code descriptions are:
Return code descriptions are:
* 0 NO_ERROR
* 0         NO_ERROR
*11 ERROR_INVALID_VERIFY_SWITCH
* 11       ERROR_INVALID_VERIFY_SWITCH  


==Remarks==
==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.  
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==
==Bindings==
===C Binding===
===C===
<PRE>
<PRE>
#define INCL_DOSFILEMGR
#define INCL_DOSFILEMGR
Line 26: Line 24:
USHORT  rc = DosSetVerify(VerifySetting);
USHORT  rc = DosSetVerify(VerifySetting);


USHORT           VerifySetting; /* New value of verify switch */
USHORT VerifySetting; /* New value of verify switch */
 
USHORT rc;            /* return code */
USHORT           rc;            /* return code */
</PRE>
</PRE>


===MASM Binding===
===MASM===
<PRE>
<PRE>
EXTRN  DosSetVerify:FAR
EXTRN  DosSetVerify:FAR
Line 45: Line 42:
*[[DosQVerify]]  
*[[DosQVerify]]  


[[Category:Dos]]
[[Category:Dos16]]

Latest revision as of 07:05, 26 January 2020

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:
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.

Bindings

C

#define INCL_DOSFILEMGR

USHORT  rc = DosSetVerify(VerifySetting);

USHORT  VerifySetting; /* New value of verify switch */
USHORT  rc;            /* return code */

MASM

EXTRN  DosSetVerify:FAR
INCL_DOSFILEMGR     EQU 1

PUSH   WORD    VerifySetting ;New value of verify switch
CALL   DosSetVerify

Returns WORD

Related Functions