lineTranslateDialog 関数 (tapi.h)

[アーティクル]
03/02/2024

lineTranslateDialog 関数は、ダイヤルする電話番号の現在の場所を変更し、場所を調整し、カードパラメーターを呼び出して、その効果を確認できるようにするアプリケーションモーダルダイアログボックスを表示します。

構文

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

パラメーター

hLineApp

lineInitializeEx によって返されるアプリケーションハンドル。アプリケーションで lineInitializeEx 関数がまだ呼び出されていない場合は、 hLineApp パラメーターを 0 に設定できます。

dwDeviceID

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

dwAPIVersion

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

hwndOwner

ダイアログボックスがアタッチされるウィンドウへのハンドル。関数中に作成されたウィンドウに所有者ウィンドウがないことを示す NULL 値を指定できます。

lpszAddressIn

ユーザーの変更が場所のパラメーターに及ぼす影響を示すために、ダイアログボックスの下部で使用される電話番号を含む null で終わる文字列へのポインター。数値は正規形式である必要があります。非カノニカルな場合、ダイアログボックスの電話番号部分は表示されません。このポインターは NULL のままにすることができます。この場合、ダイアログボックスの電話番号部分は表示されません。 lpszAddressIn パラメーターにサブアドレスまたは名前フィールドが含まれている場合、または最初のアドレスから CR および LF 文字で区切られた追加アドレスが含まれている場合は、ダイアログボックスで最初のアドレスのみが使用されます。

戻り値

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

LINEERR_BADDEVICEID、LINEERR_INVALPARAM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_INVALPOINTER、LINEERR_INIFILECORRUPT、LINEERR_NODRIVER、LINEERR_INUSE、LINEERR_NOMEM、LINEERR_INVALADDRESS、LINEERR_INVALAPPHANDLE、LINEERR_OPERATIONFAILED。

注釈

TAPI バージョン 2.0 以降では、このダイアログボックスの複数のインスタンスを開くことができます。 2.0 より前の TAPI バージョンでは、ダイアログボックスが既に別のアプリケーションによって表示されている場合は、LINEERR_INUSEが返されます (複数回開くことはできません)。これらのバージョンでは、TAPI は既存のダイアログボックスを前面に表示します。このエラーは、現在のアプリケーションによって渡されたアドレスに関連するすべての詳細が処理されていないことを示します。これは、そのアドレスが関数によって処理されていないためです。

アプリケーションは、この関数の後に lineGetTranslateCaps を呼び出して、ユーザーがテレフォニーアドレス変換パラメーターに加えた変更を取得し、 lineTranslateAddress を呼び出して、ユーザーの新しい選択に基づいてダイヤル可能な文字列を取得する必要があります。

アドレス変換に関連する関数 ( lineGetTranslateCaps や lineTranslateAddress など) がLINEERR_INIFILECORRUPTを返す場合、アプリケーションは lineTranslateDialog を呼び出す必要があります。 lineTranslateDialog 関数は、エラーを検出して修正し、ユーザーに対して実行されたアクションを報告します。