ITTAPI：：EnumerateAddresses 方法 (tapi3if.h)

發行項
03/13/2024

EnumerateAddresses 方法會列舉目前可用的位址。針對 C 和 C++ 應用程式提供。自動化用戶端應用程式，例如以 Visual Basic 撰寫的應用程式，必須使用 get_Addresses 方法。

語法

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

參數

[out] ppEnumAddress

IEnumAddress 介面的指標。

傳回值

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

值	意義
S_OK	方法成功。
E_POINTER	ppEnumAddress 參數不是有效的指標。
E_INVALIDARG	TAPI 物件尚未初始化。
E_OUTOFMEMORY	記憶體不足，無法執行作業。

備註

應用程式通常會使用此列舉來檢查每個位址的功能，並判斷哪些功能適用於目前用途。

如果找不到預期的位址，這可能表示尚未安裝適當的服務提供者或無法正常運作。

TAPI 會在 ITTAPI：：EnumerateAddresses 所傳回的 IEnumAddress 介面上呼叫 Addref 方法。應用程式必須在 IEnumAddress 介面上呼叫 Release 方法，以釋放與其相關聯的資源。

如果在 TAPI 會話期間建立或移除位址，應用程式將會透過 ITTAPIEventNotification 介面收到通知。如果已建立位址，例如藉由安裝隨插即用裝置，ITTAPIEventNotification：：Event 會傳回TAPIOBJECT_EVENT列舉的TE_ADDRESSCREATE成員。如果移除位址， ITTAPIEventNotification：：Event 會 傳回TE_ADDRESSREMOVE。在這些事件之後呼叫 EnumerateAddresses 將會反映目前的位址。