Difference between revisions of "DosQVerify"

From EDM2
Jump to: navigation, search
m
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[image:legacy.png]]
+
This call returns the value of the verify flag.
This function has been renamed to "[[OS2_API:CPI:DosQueryVerify|DosQueryVerify]]". [https://books.google.com.ec/books?id=u7WbsmbttwYC&pg=PT372&lpg=PT372&dq#v=onepage&q&f=false]
+
  
==Description==
 
This call returns the value of the verify flag.
 
 
==Syntax==
 
==Syntax==
<PRE>
+
  DosQVerify (VerifySetting)
  DosQVerify
+
 
+
    (VerifySetting)
+
</PRE>
+
  
 
==Parameters==
 
==Parameters==
; VerifySetting (PUSHORT) - output : Address of the verify mode for the process.
+
;VerifySetting (PUSHORT) - output : Address of the verify mode for the process.
 
+
::00H - Verify mode is not active.
'''Value        Definition'''
+
::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:
 
+
*0 NO_ERROR
Return code description is:
+
 
+
* 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/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==
+
==Bindings==
=== C Binding===
+
=== C ===
 
<PRE>
 
<PRE>
 
#define INCL_DOSFILEMGR
 
#define INCL_DOSFILEMGR
Line 35: Line 23:
 
USHORT  rc = DosQVerify(VerifySetting);
 
USHORT  rc = DosQVerify(VerifySetting);
  
PUSHORT         VerifySetting; /* Verify setting (returned) */
+
PUSHORT VerifySetting; /* Verify setting (returned) */
 
+
USHORT rc;            /* return code */
USHORT           rc;            /* return code */
+
 
</PRE>
 
</PRE>
  
===MASM Binding===
+
===MASM===
 
<PRE>
 
<PRE>
 
EXTRN  DosQVerify:FAR
 
EXTRN  DosQVerify:FAR
Line 52: Line 39:
  
 
==Related Functions==
 
==Related Functions==
*  
+
* [[DosSetVerify (FAPI)|DosSetVerify]]
  
[[Category:The OS/2 API Project]]
+
[[Category:Dos16]]

Latest revision as of 04:27, 26 January 2020

This call returns the value of the verify flag.

Syntax

DosQVerify (VerifySetting)

Parameters

VerifySetting (PUSHORT) - output 
Address of the verify mode for the process.
00H - Verify mode is not active.
01H - Verify mode is active.

Return Code

rc (USHORT) - return
Return code description is:
  • 0 NO_ERROR

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 = DosQVerify(VerifySetting);

PUSHORT VerifySetting; /* Verify setting (returned) */
USHORT  rc;            /* return code */

MASM

EXTRN  DosQVerify:FAR
INCL_DOSFILEMGR     EQU 1

PUSH@  WORD    VerifySetting ;Verify setting (returned)
CALL   DosQVerify

Returns WORD

Related Functions