itAddress：:p ut_DoNotDisturb 方法 (tapi3if.h)

项目
03/02/2024

put_DoNotDisturb 方法设置“请勿打扰”状态。请勿打扰功能可能并非在所有地址上都可用。

语法

HRESULT put_DoNotDisturb(
  [in] VARIANT_BOOL fDoNotDisturb
);

参数

[in] fDoNotDisturb

如果VARIANT_TRUE，将激活“请勿打扰”功能。如果VARIANT_FALSE，则“请勿打扰”功能将停用，并取消所有转发。

返回值

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

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	fDoNotDisturb 参数不是有效的指针。
E_OUTOFMEMORY	内存不足，无法执行操作。
TAPI_E_TIMEOUT	操作失败，因为 TAPI 3 DLL 使其超时。超时间隔为两分钟。

注解

DoNotDisturb 功能是使用转发实现的。如果使用 VARIANT_TRUE 调用put_DoNotDisturb ，Tapi3.dll 将创建一个 LINEFORWARD 列表，该列表的模式设置为 LINEFORWARDMODE_UNCOND，并且仅创建一个目标地址设置为 NULL 的 LINEFORWARD 项。如果使用 VARIANT_FALSE 调用put_DoNotDisturb，Tapi3.dll 会完全取消此地址上的转发，即使是使用 ITAddress：：Forward 设置的转发规则也是如此。