ITLegacyCallMediaControl：：GetID 方法 (tapi3if.h)

GetID方法會取得與目前呼叫相關聯的裝置識別碼。

此方法適用于 C/C++ 應用程式。 Visual Basic 和腳本應用程式應該使用 ITLegacyCallMediaControl2：：GetIDAsVariant 方法。

語法

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

[in] pDeviceClass

代表TAPI 裝置類別的BSTR指標。

[out] pdwSize

以位元組為單位的裝置識別碼大小。

[out] ppDeviceID

裝置識別碼。

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

傳回碼	描述
S_OK	方法成功。
E_OUTOFMEMORY	記憶體不足，無法執行作業。
E_POINTER	pdwSize或ppDeviceID參數不是有效的指標。

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

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

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