共用方式為

ITAddressTranslation：：TranslateDialog 方法 (tapi3if.h)

  • 發行項

TranslateDialog 方法會顯示應用程式模式對話框，可讓使用者變更即將撥號的電話號碼目前位置、調整位置和通話卡參數，並查看效果。

語法

HRESULT TranslateDialog(
  [in] TAPIHWND hwndOwner,
  [in] BSTR     pAddressIn
);

參數

[in] hwndOwner

要附加對話框之視窗的句柄。 可以是 NULL 值，表示函式期間建立的任何視窗都應該沒有擁有者視窗。

[in] pAddressIn

BSTR 的指標，其中包含用來顯示使用者對位置參數變更效果的電話號碼。 數字必須是標準格式。 此指標可以保留 NULL，在此情況下，不會顯示對話框的電話號碼部分。 如果 pAddressIn 參數包含子位址或名稱字段，或以 ASCII CR 和 LF 字元分隔的第一個位址，則對話框中只會使用第一個位址。

傳回值

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

傳回碼 描述
S_OK
 方法成功。
E_INVALIDARG
 hwndOwner 參數不是有效的句柄，或 pAddressIn 參數不是有效的電話號碼。
E_POINTER
 pAddressIn 參數不是有效的指標。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。
E_UNEXPECTED
 發生意外錯誤。
TAPI_E_REGISTRY_SETTING_CORRUPT
 地址轉譯的登錄設定無效。
TAPI_E_NODRIVER
 沒有 TSP 可以為此地址進行翻譯。
TAPI_E_INUSE
 對話框已經開啟且正在使用中。
TAPI_E_INVALADDRESS
 目前的地址無效。
TAPI_E_OPERATIONFAILED
 TAPI 無法完成作業。

備註

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

TranslateDialog 方法是 TAPI 2.1 LineTranslateDialog 函式的 COM 包裝函式。

規格需求

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

另請參閱

Address 物件

ITAddressTranslation

LineTranslateDialog