ITAddress：：get_DoNotDisturb 方法 (tapi3if.h)

项目
08/26/2023

get_DoNotDisturb 方法获取地址上“请勿打扰”功能的当前状态。请勿打扰功能可能并非在所有地址上都可用。

语法

HRESULT get_DoNotDisturb(
  [out] VARIANT_BOOL *pfDoNotDisturb
);

参数

[out] pfDoNotDisturb

如果VARIANT_TRUE，则表示“请勿打扰”功能已激活。如果VARIANT_FALSE，则“请勿打扰”功能未处于活动状态。

返回值

此方法可以返回其中一个值。

返回代码	说明
S_OK	方法成功。
E_OPERATIONUNAVAIL	操作不可用。
TAPI_E_NOTSUPPORTED	此地址不支持此操作。
E_POINTER	pfDoNotDisturb 参数不是有效的指针。
E_OUTOFMEMORY	内存不足，无法执行操作。

注解

适用于熟悉 TAPI 2 的程序员。X： DoNotDisturb 功能是使用“转发”功能实现的（如果地址上存在）。调用 get_DoNotDisturb 时，Tapi3.dll 获取地址对象的 LINEADDRESSSTATUS ，并查找其 LINEFORWARD 条目。如果找到一个此类条目，并且其 dwDestAddressOffset 成员为 0 (零) ，则 DoNotDisturb 被视为打开，因此VARIANT_TRUE将作为此方法的值返回。