en:docs:fapi:dossetverify

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:docs:fapi:dossetverify [2018/09/01 17:18] prokusheven:docs:fapi:dossetverify [2021/12/05 11:03] (current) prokushev
Line 1: Line 1:
-{{logos:os2.gif?35x35}} {{logos:dos.gif?35x35}}+{{page>en:templates:fapiint}} 
 ====== DosSetVerify ====== ====== DosSetVerify ======
  
 This call sets the verify switch. This call sets the verify switch.
  
-==Syntax==+===== Syntax =====
  
-  DosSetVerify (VerifySetting)+<code c> 
 +DosSetVerify (VerifySetting) 
 +</code>
  
-==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 +
-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== +rc ([[USHORT]]) - return 
-===C Binding=== +   
-<PRE> +Return code descriptions are: 
-#define INCL_DOSFILEMGR+  * 0         NO_ERROR 
 +  * 11        ERROR_INVALID_VERIFY_SWITCH 
  
-USHORT  rc DosSetVerify(VerifySetting);+===== Remarks =====
  
-USHORT           VerifySetting; /* New value of verify switch */ 
  
-USHORT           rc;            /* return code */ +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. 
-</PRE>+
  
-===MASM Binding=== +===== Example Code ===== 
-<PRE> +==== C Binding ==== 
-EXTRN  DosSetVerify:FAR +<code c>
-INCL_DOSFILEMGR     EQU 1+
  
-PUSH   WORD    VerifySetting ;New value of verify switch +  #define INCL_DOSFILEMGR 
-CALL   DosSetVerify+   
 +  USHORT  rc = DosSetVerify(VerifySetting); 
 +   
 +  USHORT           VerifySetting; /* New value of verify switch */ 
 +   
 +  USHORT           rc;            /* return code */ 
 +</code>
  
-Returns WORD +==== MASM Binding ====
-</PRE>+
  
 +<code asm>
 +  EXTRN  DosSetVerify:FAR
 +  INCL_DOSFILEMGR     EQU 1
 +  
 +  PUSH   WORD    VerifySetting ;New value of verify switch
 +  CALL   DosSetVerify
 +</code>
 +Returns WORD
  
-====== Note ======+===== Note =====
  
 Text based on [[http://www.edm2.com/index.php/DosSetVerify_(FAPI)]] Text based on [[http://www.edm2.com/index.php/DosSetVerify_(FAPI)]]