en:docs:fapi:dosqverify

Differences

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

Link to this comparison view

Next revisionBoth sides next revision
en:docs:fapi:dosqverify [2018/08/31 09:26] – created prokusheven:docs:fapi:dosqverify [2018/09/02 01:25] prokushev
Line 1: Line 1:
 +{{logos:os2.gif?35x35}} {{logos:dos.gif?35x35}}
 +
 +====== DosQVerify ======
  
 This call returns the value of the verify flag. This call returns the value of the verify flag.
  
 ==Syntax== ==Syntax==
- DosQVerify (VerifySetting)+ 
 +  DosQVerify (VerifySetting)
  
 ==Parameters== ==Parameters==
-;VerifySetting (PUSHORT) - output : Address of the verify mode for the process. + 
-:00H - Verify mode is not active. +  * VerifySetting (PUSHORT) - output : Address of the verify mode for the process. 
-:01H - Verify mode is active.+ 
 +    *00H - Verify mode is not active. 
 +    *01H - Verify mode is active.
  
 ==Return Code== ==Return Code==
- rc (USHORT) - return+ 
 +  rc (USHORT) - return 
 +  
 Return code description is: Return code description is:
-* 0    NO_ERROR+ 
 +  * 0    NO_ERROR
  
 ==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 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 = DosQVerify(VerifySetting); +  #define INCL_DOSFILEMGR 
- +   
-PUSHORT          VerifySetting; /* Verify setting (returned) */ +  USHORT  rc = DosQVerify(VerifySetting); 
- +   
-USHORT           rc;            /* return code */ +  PUSHORT          VerifySetting; /* Verify setting (returned) */ 
-</PRE>+   
 +  USHORT           rc;            /* return code */
  
 ===MASM Binding=== ===MASM Binding===
-<PRE> 
-EXTRN  DosQVerify:FAR 
-INCL_DOSFILEMGR     EQU 1 
  
-PUSH@  WORD    VerifySetting ;Verify setting (returned) +  EXTRN  DosQVerify:FAR 
-CALL   DosQVerify+  INCL_DOSFILEMGR     EQU 1 
 +   
 +  PUSH@  WORD    VerifySetting ;Verify setting (returned) 
 +  CALL   DosQVerify
  
 Returns WORD Returns WORD
-</PRE> 
- 
- 
  
 ====== Note ====== ====== Note ======