TUISPI_lineConfigDialog関数 (tspi.h)

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

TUISPI_lineConfigDialog関数を使用すると、指定したラインデバイスのプロバイダーは、hwndOwner の子ウィンドウとしてモーダルダイアログボックスを表示し、ユーザーが回線デバイスに関連するパラメーターを構成できるようにします。この関数により、 TSPI_lineConfigDialog 関数はバージョン 2.0 以降 (バージョン 1.4 以前でサポート) で廃止されます。

実装は省略可能です。

構文

LONG TSPIAPI TUISPI_lineConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

パラメーター

lpfnUIDLLCallback

UI DLL が呼び出すことができる関数へのポインターを使用して、サービスプロバイダー DLL と通信して、ダイアログボックスを表示し、更新された構成をサービスプロバイダーに送信するために必要な情報を取得できます。

dwDeviceID

構成する回線デバイス。

hwndOwner

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

lpszDeviceClass

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

戻り値

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

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

注釈

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

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