ITAddressTranslation::EnumerateLocations 方法 (tapi3if.h)
EnumerateLocations 方法會列舉目前可用的位址位置。 這個方法適用於 C 和 C++ 應用程式。 自動化用戶端應用程式,例如以 Visual Basic 撰寫的用戶端應用程式,必須使用 get_Locations 方法。
語法
HRESULT EnumerateLocations(
[out] IEnumLocation **ppEnumLocation
);
參數
[out] ppEnumLocation
已建立 IEnumLocation 物件的指標。
傳回值
這個方法可以傳回其中一個值。
值 | 意義 |
---|---|
|
方法成功。 |
|
ppEnumLocations 參數不是有效的指標。 |
|
記憶體不足,無法建立物件。 |
備註
EnumerateLocations 方法是 TAPI 2.1 LineGetTranslateCaps 函式的 COM 包裝函式,並從該函式傳回的 LINETRANSLATECAPS 結構取得位置資訊。
TAPI 會在 ITAddressTranslation::EnumerateLocations 所傳回的 IEnumLocation 介面上呼叫 AddRef 方法。 應用程式必須在 IEnumLocation 介面上呼叫 Release,以釋放與其相關聯的資源。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi3if.h (包括 Tapi3.h) |
程式庫 | Uuid.lib |
Dll | Tapi3.dll |