Compartilhar via


Método ITAddress::p ut_DoNotDisturb (tapi3if.h)

O método put_DoNotDisturb define o status não incomodar. O recurso não incomodar pode não estar disponível em todos os endereços.

Sintaxe

HRESULT put_DoNotDisturb(
  [in] VARIANT_BOOL fDoNotDisturb
);

Parâmetros

[in] fDoNotDisturb

Se VARIANT_TRUE, o recurso não incomodar será ativado. Se VARIANT_FALSE, o recurso não incomodar será desativado e todo o encaminhamento será cancelado.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_INVALIDARG
O parâmetro fDoNotDisturb não é um ponteiro válido.
E_OUTOFMEMORY
Existe memória insuficiente para executar a operação.
TAPI_E_TIMEOUT
A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos.

Comentários

O recurso DoNotDisturb é implementado usando o encaminhamento. Se put_DoNotDisturb for chamado com VARIANT_TRUE, Tapi3.dll criará uma lista LINEFORWARD com o modo definido como LINEFORWARDMODE_UNCOND e apenas um item LINEFORWARD com o endereço de destino definido como NULL. Se put_DoNotDisturb for chamado com VARIANT_FALSE, Tapi3.dll cancelará completamente o encaminhamento nesse endereço, mesmo aquelas regras de encaminhamento definidas com ITAddress::Forward.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

Objeto Address

ITAddress

get_DoNotDisturb