itAddress::p ut_DoNotDisturb 方法 (tapi3if.h)
put_DoNotDisturb 方法设置“请勿打扰”状态。 请勿打扰功能可能并非在所有地址上都可用。
语法
HRESULT put_DoNotDisturb(
[in] VARIANT_BOOL fDoNotDisturb
);
参数
[in] fDoNotDisturb
如果VARIANT_TRUE,将激活“请勿打扰”功能。 如果VARIANT_FALSE,则“请勿打扰”功能将停用,并取消所有转发。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
fDoNotDisturb 参数不是有效的指针。 |
|
内存不足,无法执行操作。 |
|
操作失败,因为 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 |