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