ITAddressTranslation::EnumerateLocations 方法 (tapi3if.h)

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

語法

HRESULT EnumerateLocations(
  [out] IEnumLocation **ppEnumLocation
);

參數

[out] ppEnumLocation

已建立 IEnumLocation 物件的指標。

傳回值

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

意義
S_OK
方法成功。
E_POINTER
ppEnumLocations 參數不是有效的指標。
E_OUTOFMEMORY
記憶體不足,無法建立物件。

備註

EnumerateLocations 方法是 TAPI 2.1 LineGetTranslateCaps 函式的 COM 包裝函式,並從該函式傳回的 LINETRANSLATECAPS 結構取得位置資訊。

TAPI 會在 ITAddressTranslation::EnumerateLocations 所傳回的 IEnumLocation 介面上呼叫 AddRef 方法。 應用程式必須在 IEnumLocation 介面上呼叫 Release,以釋放與其相關聯的資源。

規格需求

需求
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)
程式庫 Uuid.lib
Dll Tapi3.dll

另請參閱

Address 物件

IEnumLocation

ITAddressTranslation