en:docs:fapi:dossetverify

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
Next revisionBoth sides next revision
en:docs:fapi:dossetverify [2018/08/30 14:52] – created prokusheven:docs:fapi:dossetverify [2018/09/01 17:29] – prokushev
Line 1: Line 1:
 +{{logos:os2.gif?35x35}} {{logos:dos.gif?35x35}}
 +====== DosSetVerify ======
 +
 This call sets the verify switch. This call sets the verify switch.
  
 ==Syntax== ==Syntax==
- DosSetVerify (VerifySetting)+ 
 +  DosSetVerify (VerifySetting)
  
 ==Parameters== ==Parameters==
-;VerifySetting (USHORT) - input : New state of Verify Mode for the requesting process as shown below: + 
- '''Value        Definition''' +  * 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.+^ Value     ^ Definition ^ 
 +| 0 | Verify mode is not 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== ==Example Code==
 ===C Binding=== ===C Binding===
-<PRE> 
-#define INCL_DOSFILEMGR 
- 
-USHORT  rc = DosSetVerify(VerifySetting); 
- 
-USHORT           VerifySetting; /* New value of verify switch */ 
  
-USHORT           rc;            /* return code */ +  #define INCL_DOSFILEMGR 
-</PRE>+   
 +  USHORT  rc = DosSetVerify(VerifySetting); 
 +   
 +  USHORT           VerifySetting; /* New value of verify switch */ 
 +   
 +  USHORT           rc;            /* return code */
  
 ===MASM Binding=== ===MASM Binding===
-<PRE> 
-EXTRN  DosSetVerify:FAR 
-INCL_DOSFILEMGR     EQU 1 
  
-PUSH   WORD    VerifySetting ;New value of verify switch +  EXTRN  DosSetVerify:FAR 
-CALL   DosSetVerify+  INCL_DOSFILEMGR     EQU 1 
 +   
 +  PUSH   WORD    VerifySetting ;New value of verify switch 
 +  CALL   DosSetVerify
  
 Returns WORD Returns WORD
-</PRE>