TSPI_phoneConfigDialog関数 (tspi.h)

TSPI_phoneConfigDialog関数は廃止されました。 TAPI バージョン 1.4 以前のサービス プロバイダーは、この TSPI 関数を実装できます。 TAPI バージョン 2.0 以降の TSP は 、TUISPI_phoneConfigDialogを実装します。

TSPI_phoneConfigDialog関数を使用すると、指定した電話デバイスのプロバイダーが hwndOwner の子ウィンドウとしてモーダル ダイアログ ボックスを表示し、ユーザーが電話デバイスに関連するパラメーターを構成できるようにします。

構文

LONG TSPIAPI TSPI_phoneConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

パラメーター

dwDeviceID

構成する電話デバイス。

hwndOwner

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

lpszDeviceClass

デバイス クラス名を識別する null で終わる Unicode 文字列へのポインター。 このデバイス クラスを使用すると、呼び出し元は、そのデバイス クラスに適用できる構成情報の特定のサブ画面を選択できます。 このパラメーターが NULL または空の文字列の場合は、最上位レベルの構成ダイアログ ボックスが選択されます。

戻り値

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

PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_INUSE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPARAM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_RESOURCEUNAVAIL。

注釈

TSPI_phoneConfigDialog、サービス プロバイダーは、ユーザーが dwDeviceID で指定された電話に関連するパラメーターを構成できるように、hWndOwner の子ウィンドウとしてモーダル ダイアログ ボックスを表示します。 lpszDeviceClass パラメーターを使用すると、アプリケーションは、ユーザーが関心のあるデバイス クラスに適用できる構成情報の特定のサブ画面を選択できます。 許可される文字列は、 TSPI_phoneGetIDの場合と同じです。 たとえば、電話が Comm API をサポートしている場合、comm/datamodem を lpszDeviceClass として渡すと、プロバイダーは Comm に関連するパラメーターを表示します (または、少なくとも、ユーザーが目的のパラメーターを検索する必要がないように、マルチレベル構成ダイアログ ボックス チェーン内の対応するポイントから開始します)。 プロバイダーが電話の最高レベルの構成を表示するには、 szDeviceClass パラメーターを "tapi/phone"、""、または NULL にする必要があります。

この手順では、Win.ini ファイルの [Windows テレフォニー] セクションを更新し、アプリケーション ( PHONECAPS など) に表示される構造体の内容に影響を与える Telephon.ini に変更を加える場合、または電話デバイスが作成または削除された場合に、WM_WININICHANGE メッセージをブロードキャストする必要があります。

要件

こちらもご覧ください

PHONECAPS

TSPI_phoneGetID