Bagikan melalui


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
S_OK
Metode berhasil.
E_FAIL
Metode gagal. Ini mungkin berarti tidak ada perangkat dari kelas tertentu yang terkait dengan alamat saat ini.
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 .

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

Lihat juga

GetDevConfig

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig