TSPI_lineConfigDialog関数 (tspi.h)

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

TSPI_lineConfigDialog関数は廃止されました。 TAPI バージョン 1.4 以前のサービスプロバイダーは、この TSPI 関数を実装できます。 TAPI バージョン 2.0 以降の TSP は、TUISPI_lineConfigDialogを実装します。

TSPI_lineConfigDialog関数を使用すると、指定した回線デバイスのプロバイダーは、hwndOwner の子ウィンドウとしてモーダルダイアログボックスを表示し、ユーザーが回線デバイスに関連するパラメーターを構成できるようにします。

構文

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

パラメーター

dwDeviceID

構成する回線デバイス。

hwndOwner

ダイアログボックスウィンドウを配置する親ウィンドウへのハンドル。

lpszDeviceClass

デバイスクラス名を識別する null で終わる Unicode 文字列へのポインター。このデバイスクラスを使用すると、呼び出し元は、そのデバイスクラスに適用できる構成情報の特定のサブ画面を選択できます。このパラメーターが NULL または空の文字列の場合は、最上位レベルの構成ダイアログボックスを選択する必要があります。許可される文字列は、 TSPI_lineGetIDの場合と同じです。たとえば、行が Comm API をサポートしている場合、comm/datamodem を lpszDeviceClass として渡すと、プロバイダーは Comm に関連するパラメーターを表示します (または、少なくとも、ユーザーが目的のパラメーターを検索する必要がないように、マルチレベル構成ダイアログボックスチェーン内の対応するポイントから開始します)。

戻り値

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

LINEERR_INUSE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注釈

この手順では、 LINEDEVCAPS または LINEADDRESSCAPS で報告された行またはアドレス機能の変更を引き起こす Telephon.ini ファイルに変更を加えた場合、または回線デバイスが作成または削除された場合に、Win.ini ファイルの [Windows テレフォニー] セクションを更新し、WM_WININICHANGE メッセージをブロードキャストする必要があります。

この関数 (TSPI_lineConfigDialog) は、行が閉じられたときにのみ呼び出されるという制限はありません。ただし、各プロバイダーは、このような制限自体を課すことができます。 TSPI_lineConfigDialogが呼び出されると、プロバイダーは"行は 1 つ以上のアプリケーションで使用中です" というメッセージでユーザーに警告する可能性があります。行が使用中に行の構成を変更することはできません (エラーメッセージ LINEERR_INUSEを返します)。ただし、一部の構成では、特にメディアの種類 (モデムエラー制御プロトコルなど) に関連するもの、特にそのメディアの種類が現在使用されていない場合は、"オンザフライ" に変更しても安全な場合があります。プロバイダーは、行が開いている間にこれらのオプションを変更することを許可できます。

正確な情報を得るために、アプリケーションがこれらの構造体を返す関数を呼び出す必要があることを示すシグナルとして、 LINEDEVCAPS または LINEADDRESSCAPS で返される値を変更するものは、ユーザーが最初に強制的に行を閉じないようにすることはできません。