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

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 设置的转发规则也是如此。

要求

要求
目标平台 Windows
标头 tapi3if.h (包括 Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

另请参阅

Address 对象

ITAddress

get_DoNotDisturb