次の方法で共有

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 を含む)
Library Uuid.lib
[DLL] Tapi3.dll

こちらもご覧ください

Address オブジェクト

ITAddressTranslation

LineTranslateDialog