METODE ITLegacyAddressMediaControl::GetID (tapi3if.h)
Metode GetID mengembalikan pengidentifikasi perangkat untuk kelas perangkat tertentu yang terkait dengan alamat saat ini.
Metode ini hanya ditujukan untuk aplikasi C/C++. Tidak ada metode yang sesuai yang tersedia untuk Aplikasi Visual Basic dan pembuatan skrip.
Sintaks
HRESULT GetID(
[in] BSTR pDeviceClass,
[out] DWORD *pdwSize,
[out] BYTE **ppDeviceID
);
Parameter
[in] pDeviceClass
Pointer ke BSTR yang berisi kelas perangkat TAPI yang informasi konfigurasinya diperlukan.
[out] pdwSize
Panjang pengidentifikasi perangkat yang dikembalikan.
[out] ppDeviceID
Pengidentifikasi perangkat.
Mengembalikan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
Metode gagal. Ini mungkin berarti tidak ada perangkat dari kelas tertentu yang terkait dengan alamat saat ini. |
|
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 .
TAPI 2.1 Referensi Silang: lineGetDevConfig, lineSetDevConfig, lineGetID
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | tapi3if.h (termasuk Tapi3.h) |
Pustaka | Uuid.lib |
DLL | Tapi3.dll |