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

Artigo
03/02/2024

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.