lineConfigDialogA 関数 (tapi.h)

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

構文

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

パラメーター

dwDeviceID

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

hwndOwner

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

lpszDeviceClass

デバイス クラス名を識別する -terminated 文字列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 になり、プロバイダーに行の最上位レベルの構成が表示されます。

手記

tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineConfigDialog を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	tapi.h
ライブラリ	Tapi32.lib
DLL	Tapi32.dll

関連項目

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

TAPI 2.2 リファレンスの概要

lineGetID を する