Método ITAddress::get_DoNotDisturb (tapi3if.h)

  • Artigo

O método get_DoNotDisturb obtém a status atual do recurso não incomodar no endereço. O recurso não incomodar pode não estar disponível em todos os endereços.

Sintaxe

HRESULT get_DoNotDisturb(
  [out] VARIANT_BOOL *pfDoNotDisturb
);

Parâmetros

[out] pfDoNotDisturb

Se VARIANT_TRUE, o recurso não incomodar foi ativado. Se VARIANT_FALSE, o recurso não incomodar não estará ativo.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_OPERATIONUNAVAIL
 Operação indisponível.
TAPI_E_NOTSUPPORTED
 Não há suporte para essa operação neste endereço.
E_POINTER
 O parâmetro pfDoNotDisturb não é um ponteiro válido.
E_OUTOFMEMORY
 Há memória insuficiente para executar a operação.

Comentários

Para programadores familiarizados com o TAPI 2. X: O recurso DoNotDisturb é implementado usando o recurso "encaminhar", se estiver presente no endereço. Quando get_DoNotDisturb é chamado, Tapi3.dll obtém o LINEADDRESSSTATUS do objeto de endereço e procura suas entradas LINEFORWARD . Se uma dessas entradas for encontrada e seu membro dwDestAddressOffset for 0 (zero), DoNotDisturb será considerado ativado e, portanto, VARIANT_TRUE será retornado como o valor para esse método.

Requisitos

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

Confira também

Objeto Address

ITAddress

put_DoNotDisturb