lineTranslateAddress 関数 (tapi.h)

[アーティクル]
03/08/2023

lineTranslateAddress 関数は、指定したアドレスを別の形式に変換します。

構文

LONG lineTranslateAddress(
  HLINEAPP              hLineApp,
  DWORD                 dwDeviceID,
  DWORD                 dwAPIVersion,
  LPCSTR                lpszAddressIn,
  DWORD                 dwCard,
  DWORD                 dwTranslateOptions,
  LPLINETRANSLATEOUTPUT lpTranslateOutput
);

パラメーター

hLineApp

lineInitializeEx によって返されるハンドル。 TAPI 2.x アプリケーションで lineInitializeEx 関数がまだ呼び出されていない場合は、このパラメーターを NULL に設定できます。 TAPI 1.4 アプリケーションでは、引き続き lineInitialize を最初に呼び出す必要があります。

dwDeviceID

異なる回線のダイヤル手順のバリエーションを変換プロセスに適用できるように、呼び出しがダイヤルされる回線デバイスのデバイス識別子。

dwAPIVersion

アプリケーションでサポートされている TAPI の最高バージョン (特定の回線デバイスで lineNegotiateAPIVersion によってネゴシエートされる値とは限りません)。

lpszAddressIn

変換のために抽出される情報のアドレスを含む null で終わる文字列へのポインター。正規のアドレス形式、またはダイヤル可能な数字の任意の文字列 (非正規) である必要があります。このパラメーターは NULL にすることはできません。 AddressIn にサブアドレスまたは名前フィールドが含まれている場合、または CR および LF 文字で最初のアドレスから区切られた追加のアドレスが含まれている場合は、最初のアドレスのみが変換されます。

dwCard

ダイヤルに使用するクレジットカード。このパラメーターは、CARDOVERRIDE ビットが dwTranslateOptions で設定されている場合にのみ有効です。このパラメーターは、CurrentLocation の定義で指定された PreferredCardID の代わりに使用する必要があるレジストリ (lineTranslateCaps から取得) の [Cards] セクションの Card エントリの永続的な識別子を指定します。レジストリの現在の Location エントリの PreferredCardID パラメーターは変更されません。オーバーライドは、現在の翻訳操作にのみ適用されます。 CARDOVERRIDE ビットが dwTranslateOptions で設定されていない場合、このパラメーターは無視されます。

dwTranslateOptions

アドレスをダイヤル可能な文字列に変換する前に実行される関連する操作。このパラメーターでは、 LINETRANSLATEOPTION_定数のいずれかを使用します。

LINETRANSLATEOPTION_CANCELCALLWAITING ビットを設定した場合は、LINECALLPARAMS 構造体の dwCallParamFlags メンバーにLINECALLPARAMFLAGS_SECURE ビットを設定することもお勧めします (lpCallParams パラメーターを介して lineMakeCall に渡されます)。これにより、回線デバイスでダイヤル可能な数字を使用して通話割り込みを抑制できなくなります。

lpTranslateOutput

LINETRANSLATEOUTPUT 型の変換操作の出力を格納する、アプリケーションによって割り当てられたメモリ領域へのポインター。 lineTranslateAddress を呼び出す前に、情報を返すために TAPI が使用できるメモリの量を示すために、アプリケーションはこの構造体の dwTotalSize メンバーを設定する必要があります。

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。可能な戻り値は次のとおりです。

LINEERR_BADDEVICEID、LINEERR_INVALPOINTER、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NODRIVER、LINEERR_INIFILECORRUPT、LINEERR_NOMEM、LINEERR_INVALADDRESS、LINEERR_OPERATIONFAILED、LINEERR_INVALAPPHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALCARD、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPARAM。