Differences

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

--- en:docs:fapi:dossetverify [2018/08/30 14:52] – created prokushev
+++ en:docs:fapi:dossetverify [2021/12/05 11:03] (current) – prokushev
@@ Line 1: / Line 1: @@
+{{page>en:templates:fapiint}}
+====== DosSetVerify ======
 This call sets the verify switch.
-==Syntax==
+===== Syntax =====
- DosSetVerify (VerifySetting)
-==Parameters==
+<code c>
-;VerifySetting (USHORT) - input : New state of Verify Mode for the requesting process as shown below:
+DosSetVerify (VerifySetting)
- '''Value        Definition'''
+</code>
-        Verify mode is not active.
-        Verify mode is active.
-==Return Code==
+===== Parameters =====
- rc (USHORT) - return
-Return code descriptions are:
-* 0         NO_ERROR
-* 11        ERROR_INVALID_VERIFY_SWITCH
-==Remarks==
+  * VerifySetting ([[USHORT]]) - input : New state of Verify Mode for the requesting process as shown below:
-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==
+^ Value     ^ Definition ^
-===C Binding===
+| 0 | Verify mode is not active. |
-<PRE>
+| 1 | Verify mode is active. |
-#define INCL_DOSFILEMGR
-USHORT  rc = DosSetVerify(VerifySetting);
+===== Return Code =====
-USHORT           VerifySetting; /* New value of verify switch */
-USHORT           rc;            /* return code */
+rc ([[USHORT]]) - return
-</PRE>
+Return code descriptions are:
+  * 0         NO_ERROR
+  * 11        ERROR_INVALID_VERIFY_SWITCH
-===MASM Binding===
+===== Remarks =====
-<PRE>
-EXTRN  DosSetVerify:FAR
-INCL_DOSFILEMGR     EQU 1
-PUSH   WORD    VerifySetting ;New value of verify switch
-CALL   DosSetVerify
-Returns WORD
+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>
+===== Example Code =====
+==== C Binding ====
+<code c>
+  #define INCL_DOSFILEMGR
+  USHORT  rc = DosSetVerify(VerifySetting);
+  USHORT           VerifySetting; /* New value of verify switch */
+  USHORT           rc;            /* return code */
+</code>
+==== MASM Binding ====
+<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)]]