Metode ITAddress::get_DoNotDisturb (tapi3if.h)

Artikel
08/26/2023

Metode get_DoNotDisturb mendapatkan status saat ini dari fitur jangan ganggu pada alamat. Fitur jangan ganggu mungkin tidak tersedia di semua alamat.

Sintaks

HRESULT get_DoNotDisturb(
  [out] VARIANT_BOOL *pfDoNotDisturb
);

Parameter

[out] pfDoNotDisturb

Jika VARIANT_TRUE, fitur jangan ganggu telah diaktifkan. Jika VARIANT_FALSE, fitur jangan ganggu tidak aktif.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_OPERATIONUNAVAIL	Operasi tidak tersedia.
TAPI_E_NOTSUPPORTED	Operasi ini tidak didukung pada alamat ini.
E_POINTER	Parameter pfDoNotDisturb bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup ada untuk melakukan operasi.

Keterangan

Untuk programmer yang akrab dengan TAPI 2. X: Fitur DoNotDisturb diimplementasikan menggunakan fitur "teruskan", jika ada di alamat. Ketika get_DoNotDisturb dipanggil, Tapi3.dll mendapatkan LINEADDRESSSTATUS dari objek alamat, dan mencari entri LINEFORWARD-nya . Jika satu entri tersebut ditemukan dan jika anggota dwDestAddressOffset adalah 0 (nol), maka DoNotDisturb dianggap diaktifkan, dan oleh karena itu VARIANT_TRUE dikembalikan sebagai nilai untuk metode ini.