ITLegacyAddressMediaControl：：GetID 方法 (tapi3if.h)

GetID 方法會針對與目前位址相關聯的指定裝置類別傳回裝置標識碼。

這個方法僅適用於 C/C++ 應用程式。 Visual Basic 和腳本應用程式沒有對應的方法。

語法

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

[in] pDeviceClass

BSTR 的指標，其中包含需要設定資訊的 TAPI 裝置類別。

[out] pdwSize

傳回的裝置標識碼長度。

[out] ppDeviceID

裝置標識碼。

這個方法可以傳回其中一個值。

傳回碼	描述
S_OK	方法成功。
E_FAIL	方法失敗。這可能表示沒有與目前位址相關聯的指定類別裝置。
E_POINTER	pdwSize 或 ppDeviceID 參數不是有效的指標。

應用程式必須先呼叫 ITTAPI：：RegisterCallNotifications ，才能呼叫此方法。

應用程式必須使用 SysAllocString 為 pDeviceClass 參數配置記憶體，並使用 SysFreeString 在不再需要變數時釋放記憶體。

應用程式必須呼叫 CoTaskMemFree 函式，以釋放配置給 ppDeviceID 參數的記憶體。

TAPI 2.1 交叉參考： lineGetDevConfig、 lineSetDevConfig、 lineGetID