ITAddressTranslation::get_Locations 方法 (tapi3if.h)

get_Locations方法會建立目前可用位址位置的集合。 這個方法適用于自動化用戶端應用程式,例如以 Visual Basic 撰寫的用戶端應用程式。 C 和 C++ 應用程式必須使用 EnumerateLocations 方法。

語法

HRESULT get_Locations(
  [out] VARIANT *pVariant
);

參數

[out] pVariant

VARIANT指標,其中包含ITLocationInfo介面指標的ITCollection, (位置物件) 。

傳回值

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

意義
S_OK
方法成功。
E_POINTER
pVariant參數不是有效的指標。
E_OUTOFMEMORY
記憶體不足,無法執行作業。

備註

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

另請參閱

Address 物件

EnumerateLocations

ITAddressTranslation

ITCollection

ITLocationInfo