DosSetVerify (FAPI): Difference between revisions
Created page with "==Description== This call sets the verify switch. ==Syntax== <PRE> DosSetVerify (VerifySetting) </PRE> ==Parameters== ; VerifySetting (USHORT) - input : New state of Ve..." |
mNo edit summary |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
This call sets the verify switch. | This call sets the verify switch. | ||
==Syntax== | ==Syntax== | ||
DosSetVerify (VerifySetting) | |||
DosSetVerify | |||
==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: | ||
::0 - Verify mode is not active. | |||
::1 - Verify mode is active. | |||
==Return Code== | ==Return Code== | ||
;rc (USHORT) - return:Return code descriptions are: | |||
* 0 NO_ERROR | |||
Return code descriptions are: | *11 ERROR_INVALID_VERIFY_SWITCH | ||
* 0 | |||
* 11 | |||
==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. | ||
== | ==Bindings== | ||
===C | ===C=== | ||
<PRE> | <PRE> | ||
#define INCL_DOSFILEMGR | #define INCL_DOSFILEMGR | ||
| Line 33: | Line 24: | ||
USHORT rc = DosSetVerify(VerifySetting); | USHORT rc = DosSetVerify(VerifySetting); | ||
USHORT | USHORT VerifySetting; /* New value of verify switch */ | ||
USHORT rc; /* return code */ | |||
USHORT | |||
</PRE> | </PRE> | ||
===MASM | ===MASM=== | ||
<PRE> | <PRE> | ||
EXTRN DosSetVerify:FAR | EXTRN DosSetVerify:FAR | ||
| Line 50: | Line 38: | ||
Returns WORD | Returns WORD | ||
</PRE> | </PRE> | ||
==Related Functions== | ==Related Functions== | ||
* | *[[DosQVerify]] | ||
[[Category: | [[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