lineConfigDialog 関数 (tapi.h)

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 になり、プロバイダーに行の最上位レベルの構成が表示されます。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	tapi.h
Library	Tapi32.lib
[DLL]	Tapi32.dll

こちらもご覧ください

基本的なテレフォニー サービス リファレンス

TAPI 2.2 リファレンスの概要

lineGetID