ITLegacyCallMediaControl::Metode GetID (tapi3if.h)
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 |
---|---|
|
Metode berhasil. |
|
Tidak ada cukup memori untuk melakukan operasi. |
|
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 .
Persyaratan
Target Platform | Windows |
Header | tapi3if.h (termasuk Tapi3.h) |
Pustaka | Uuid.lib |
DLL | Tapi3.dll |