ITAddress::get_DoNotDisturb 方法 (tapi3if.h)

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将作为此方法的值返回。

要求

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

另请参阅

Address 对象

ITAddress

put_DoNotDisturb