lineConfigDialog 関数 (tapi.h)

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

lineConfigDialog 関数を使用すると、指定した回線デバイスのプロバイダーがダイアログボックス (アプリケーションの hwndOwner に接続) を表示して、ユーザーが回線デバイスに関連するパラメーターを構成できるようにします。

構文

LONG lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

パラメーター

dwDeviceID

構成する回線デバイスの識別子。

hwndOwner

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

lpszDeviceClass

デバイスクラス名を識別する null で終わる文字列へのポインター。このデバイスクラスを使用すると、アプリケーションは、そのデバイスクラスに適用できる構成情報の特定のサブ画面を選択できます。このパラメーターは省略可能であり、 NULL または空のままにすることができます。この場合、最上位レベルの構成が選択されます。

戻り値

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

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INUSE、LINEERR_OPERATIONFAILED、LINEERR_INVALDEVICECLASS、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPARAM、LINEERR_UNINITIALIZED、LINEERR_INVALPOINTER、LINEERR_OPERATIONUNAVAIL、LINEERR_NODEVICE。

注釈

lineConfigDialog 関数を使用すると、サービスプロバイダーにモーダルダイアログボックス (アプリケーションの hwndOwner にアタッチ) が表示され、dwDeviceID で指定された行に関連するパラメーターをユーザーが構成できるようになります。 lpszDeviceClass パラメーターを使用すると、アプリケーションは、ユーザーが関心のあるデバイスクラスに適用できる構成情報の特定のサブ画面を選択できます。許可される文字列は、lineGetID の場合と同じです。たとえば、行が Comm API をサポートしている場合、 lpszDeviceClass として "COMM" を渡すと、プロバイダーは Comm に関連するパラメーターを表示します (または、少なくとも、複数レベルの構成ダイアログボックスチェーン内の対応するポイントから開始するため、ユーザーが目的のパラメーターを検索するために "dig" する必要はありません)。

lpszDeviceClass パラメーターは、"tapi/line" 、""、または NULL になり、プロバイダーに行の最上位レベルの構成が表示されます。