ITAddressTranslation：：TranslateAddress 方法 (tapi3if.h)

  • 發行項

TranslateAddress 方法會建立地址轉譯資訊介面。 TranslateAddress 方法的主要目標是取得 pDestAddress 字串 (可撥號位址) 作為 ITAddress：：CreateCall 的參數。 TranslateAddress 方法會間接傳回可撥號位址，做為 ITAddressTranslationInfo 物件的其中一個屬性。

語法

HRESULT TranslateAddress(
  [in]  BSTR                     pAddressToTranslate,
  [in]  long                     lCard,
  [in]  long                     lTranslateOptions,
  [out] ITAddressTranslationInfo **ppTranslated
);

參數

[in] pAddressToTranslate

BSTR 的指標，其中包含需要翻譯的位址。

[in] lCard

用於翻譯的通話卡。

[in] lTranslateOptions

翻譯選項的指標，請參閱 LINETRANSLATEOPTION__Constants。

[out] ppTranslated

新建立 ITAddressTranslationInfo 介面的指標。

傳回值

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

值 意義
S_OK
 方法成功。
E_POINTER
 ppTranslated 參數不是有效的指標。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。
E_UNEXPECTED
 方法因不明原因而失敗。
E_INVALIDARG
 lTranslateOptions 值無效。
TAPI_E_NODRIVER
 此地址沒有與其相關聯的 TSP。
TAPI_E_REGISTRY_SETTING_CORRUPT
 登錄已損毀。
TAPI_E_OPERATIONFAILED
 方法因 TAPI 而失敗。
TAPI_E_RESOURCEUNAVAIL
 無法使用 TSP。
TAPI_E_INVALCARD
 卡片號碼無效。

備註

應用程式必須使用 SysAllocString 為 pAddressToTranslate 配置記憶體，並使用 SysFreeString 在不再需要變數時釋放記憶體。

TranslateAddress 方法是 TAPI 2.1 LineTranslateAddress 函式的 COM 包裝函式。

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

規格需求

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

另請參閱

Address 物件

可撥號位址

ITAddressTranslation