ITAddress::get_DoNotDisturb 方法 (tapi3if.h)
get_DoNotDisturb 方法获取地址上“请勿打扰”功能的当前状态。 请勿打扰功能可能并非在所有地址上都可用。
语法
HRESULT get_DoNotDisturb(
[out] VARIANT_BOOL *pfDoNotDisturb
);
参数
[out] pfDoNotDisturb
如果VARIANT_TRUE,则表示“请勿打扰”功能已激活。 如果VARIANT_FALSE,则“请勿打扰”功能未处于活动状态。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
操作不可用。 |
|
此地址不支持此操作。 |
|
pfDoNotDisturb 参数不是有效的指针。 |
|
内存不足,无法执行操作。 |
注解
适用于熟悉 TAPI 2 的程序员。X: DoNotDisturb 功能是使用“转发”功能实现的(如果地址上存在)。 调用 get_DoNotDisturb 时,Tapi3.dll 获取地址对象的 LINEADDRESSSTATUS ,并查找其 LINEFORWARD 条目。 如果找到一个此类条目,并且其 dwDestAddressOffset 成员为 0 (零) ,则 DoNotDisturb 被视为打开,因此VARIANT_TRUE将作为此方法的值返回。
要求
目标平台 | Windows |
标头 | tapi3if.h (包括 Tapi3.h) |
Library | Uuid.lib |
DLL | Tapi3.dll |