TUISPI_providerConfig関数 (tspi.h)
TUISPI_providerConfig関数は、呼び出し元アプリケーションのコンテキストで実行する必要がある UI 要素を実装します。 この関数は、 バージョン 2.0 以降 (バージョン 1.4 以前でサポートされています) でTSPI_providerConfig関数を廃止します。
TUISPI_providerConfig関数は、ユーザーから構成情報を収集します。 ダイアログ ボックスを使用できます。このダイアログ ボックスには、特定のデバイスのセットアップ用に他の API (Comm/datamodem など) に関連付けられているサブダイアログ ボックスを含めることができます。
実装は省略可能です。
構文
LONG TSPIAPI TUISPI_providerConfig(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
HWND hwndOwner,
DWORD dwPermanentProviderID
);
パラメーター
lpfnUIDLLCallback
UI DLL が呼び出すことができる関数へのポインターを使用して、サービス プロバイダー DLL と通信して、ダイアログ ボックスを表示し、更新された構成をサービス プロバイダーに送信するために必要な情報を取得できます。
hwndOwner
関数が構成中に必要なダイアログ ボックス ウィンドウを作成できる親ウィンドウのハンドル。
dwPermanentProviderID
サービス プロバイダーの永続的なプロバイダー識別子。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_OPERATIONFAILED、LINEERR_NOMEM。
注釈
この関数は、サービス プロバイダーの使用中 (つまり、 TSPI_providerInit と TSPI_providerShutdown の呼び出しの間) に呼び出される場合があります。
TSPI によって表示される動作に影響を与える変更は、サービス プロバイダーが次の TSPI_providerInitで再起動された場合にのみ有効になります。
TAPI レベルに直接対応する関数はありません。 TAPI では、アプリケーションは lineConfigDialog および phoneConfigDialog 関数にアクセスできます。これにより、インストール後に特定の回線または電話のパラメーターを構成できます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |