描述
检索有关SQLite性能的运行时状态信息,并可选择重置各种高水位标记。
PB语法
FUNCTION Status ( _ BYVAL op AS LONG, _ BYREF pCurrent AS LONG, _ BYREF pHighwater AS LONG, _ OPTIONAL BYVAL resetFlag AS LONG _ ) AS LONG |
参数
op
[in]特定satus参数的整数代码
pCurrent
[out]指向接收当前参数值的LONG变量的指针。
resetFlag
[out]指向接收参数最高记录值的LONG变量的指针。
resetFlag
[in]TRUE或FALSE。如果为true,则在此接口调用返回后,计数器将重置为零。
返回值
成功时返回SQLITE_OK,失败时返回非零错误代码。
备注
此方法用于检索关于SQLite性能的运行时状态信息,并可选择重置各种高水位标记。第一个参数是要测量的特定参数的整数代码。识别的整数代码的形式为SQLITE_STATUS _参数的当前值返回到pCurrent.记录的最高值在pHighwater中返回。如果复位标志为真,则写入pHighwater之后,最高记录值将被重置。一些参数不记录最高值。对于这些参数,没有任何内容写入pHighwater,并且复位标志被忽略。其他参数仅记录高水位标记而不是当前值。对于这些后一个参数,没有任何内容写入pCurrent.
此函数是线程安全的,但不是原子的。当其他线程运行相同或不同的SQLite接口时,可以调用此函数。但是,pCurrent和pHighwater中返回的值反映了SQLite在不同时间点的状态,并且有可能另一个线程可能会在写入pCurrent和pHighwater的时间之间更改参数。