次の方法で共有


TSPI_lineConfigDialog関数 (tspi.h)

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 で返される値を変更するものは、ユーザーが最初に強制的に行を閉じないようにすることはできません。

要件

要件
対象プラットフォーム Windows
ヘッダー tspi.h

こちらもご覧ください

LINEADDRESSCAPS

LINEDEVCAPS

TSPI_lineGetDevConfig

TSPI_lineGetID

TSPI_lineSetDevConfig