ITLegacyCallMediaControl::Metode GetID (tapi3if.h)

Artikel
08/26/2023

Metode GetID mendapatkan pengidentifikasi untuk perangkat yang terkait dengan panggilan saat ini.

Metode ini ditujukan untuk aplikasi C/C++. Aplikasi Visual Basic dan pembuatan skrip harus menggunakan metode ITLegacyCallMediaControl2::GetIDAsVariant .

Sintaks

HRESULT GetID(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceID
);

Parameter

[in] pDeviceClass

Pointer ke BSTR yang mewakili kelas perangkat TAPI.

[out] pdwSize

Ukuran dalam byte pengidentifikasi perangkat.

[out] ppDeviceID

Pengidentifikasi perangkat.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.
E_POINTER	Parameter pdwSize atau ppDeviceID bukan penunjuk yang valid.

Keterangan

Aplikasi harus memanggil ITTAPI::RegisterCallNotifications sebelum memanggil metode ini.

Aplikasi harus menggunakan SysAllocString untuk mengalokasikan memori untuk parameter pDeviceClass dan menggunakan SysFreeString untuk membebaskan memori ketika variabel tidak lagi diperlukan.

Aplikasi harus memanggil fungsi CoTaskMemFree untuk membebaskan memori yang dialokasikan untuk parameter ppDeviceID .