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 メッセージをブロードキャストする必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |