Jump to content

DosSetVerify (FAPI): Difference between revisions

From EDM2
Ak120 (talk | contribs)
Ak120 (talk | contribs)
mNo edit summary
Line 1: Line 1:
==Description==
This call sets the verify switch.
This call sets the verify switch.


==Syntax==
==Syntax==
<PRE>
  DosSetVerify (VerifySetting)
  DosSetVerify


    (VerifySetting)
</PRE>
==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'''
    '''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  
Line 36: Line 29:


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


Line 50: Line 41:
Returns WORD
Returns WORD
</PRE>
</PRE>
==Related Functions==
==Related Functions==
*  
*[[DosQVerify]]


[[Category:The OS/2 API Project]]
[[Category:Dos]]

Revision as of 13:30, 18 February 2017

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

Related Functions