ComObjError() [AHK_L 53+]

启用或禁用 COM 错误通告.

Enabled := ComObjError(Enable)

参数

Enable

如果为空或省略, 则保持设置不变. 否则, 指定一个真值(非零和非空) 来启用此设置, 或指定一个零来禁用此设置.

返回值 [v1.0.91+]

函数返回这个函数被调用之前生效的设置.

一般说明

COM 错误可能是由 ComObjCreate(), ComObjGet(), ComObjActive(), ComObjConnect(), ComObjQuery()(如果检测到无效指针) 或 COM 对象的方法或属性引起的. COM 错误会导致以下结果之一:

设置结果
0(禁止) 函数, 方法或属性返回默认值(通常为空字符串), 而不显示错误对话框.
1(激活)

如果有一个活动的 Try 块, 抛出一个异常. 否则:

显示一个错误对话框, 让用户可以选择继续执行脚本. 如果用户选择 "Yes", 函数, 方法或属性返回默认值(通常为空字符串), 脚本继续执行. 否则, 脚本将退出.

在访问 COM 对象之后, A_LastError 包含 COM 对象的 IDispatch::Invoke 函数返回的 HRESULT 码. 脚本可能会在 Catch 块中或者在方法或属性返回后, 查询 A_LastError, 前提是已经使用了 ComObjError(false) 或用户未选择退出脚本.

ComObjCreate(), ComObjGet(), ComObjActive(), ComObjConnect(), ComObjQuery()