次の方法で共有

ITAddressTranslation::TranslateAddress メソッド (tapi3if.h)

  • [アーティクル]

TranslateAddress メソッドは、アドレス変換情報インターフェイスを作成します。 TranslateAddress メソッドの主な目的は、ITAddress::CreateCall のパラメーターとして必要な pDestAddress 文字列 (ダイヤル可能なアドレス) を取得することです。 TranslateAddress メソッドは、ITAddressTranslationInfo オブジェクトのプロパティの 1 つとして、ダイヤル可能なアドレスを間接的に返します。

構文

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

こちらもご覧ください

Address オブジェクト

ダイヤル可能なアドレス

ITAddressTranslation