TSPI_providerInstall関数 (tspi.h)

[アーティクル]
03/13/2024

TSPI_providerInstall関数は古くなっています。 TAPI バージョン 1.4 以前のサービスプロバイダーは、この TSPI 関数を実装できます。 TAPI バージョン 2.0 以降の TSP は、TUISPI_providerInstallを実装します。

TSPI_providerInstall関数は、プロバイダーの追加の "部分" を適切なディレクトリにインストールし (少なくとも存在することを確認)、その回線と電話用にプロバイダーのレジストリエントリを設定し、サービスプロバイダーに必要なその他のエントリを作成します。 [追加] ボタンが押されると、テレフォニーコントロールパネルユーティリティ (バージョン 1.4 以前の Windows テレフォニーで提供) から呼び出されます。

構文

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

パラメーター

hwndOwner

関数がインストール時に必要なダイアログボックスウィンドウを作成できる親ウィンドウのハンドル。

dwPermanentProviderID

サービスプロバイダーの永続的なプロバイダー識別子。

戻り値

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

LINEERR_OPERATIONFAILED、LINEERR_INIFILECORRUPT、LINEERR_NOMEM、LINEERR_INVALPARAM。

注釈

この関数は、レジストリの [プロバイダー] セクションのエントリが作成された後、サービスプロバイダーに必要な他の部分のインストールを完了します。サービスプロバイダーが適切な操作のためにレジストリに追加のプライベート定義エントリを必要とする場合は、それらのエントリもインストールする必要があります。このセクションをエントリと共にインストールする一般的な方法は、TSPI_providerConfigを呼び出す方法です。

この関数は、システムを一貫した状態のままにしておく必要があります。完了するまで実行する必要があります。一部の完了時にユーザーがインストールを中止することはできません。インストールが失敗した場合、実行された内容を "バックアウト" し、エラーを返すのはプロバイダーの責任です。これは、インストールが開始される前に、完全なインストールが可能であることを確認するための事前スキャンを意味する可能性があります。

この関数は、サービスプロバイダーのインストール中に、TSPI_providerRemoveの呼び出しが行われるまで 1 回だけ呼び出されます。他の TSPI 定義関数の前に呼び出す必要があります。

バージョン 1.4 以前の Windows テレフォニーで提供されているテレフォニーコントロールパネルユーティリティは、"追加" コマンドが呼び出されたときにこの関数を呼び出します (ここで説明するように外部シーケンス要件が満たされています)。 "add" コマンドのTSPI_providerConfig は呼び出されません。

TAPI レベルに対応する関数はありません。このレベルでは、アプリケーションにはサービスプロバイダーが既にインストールされている必要があります。実行中のアプリケーションには、LINE_LINEDEVSTATEまたはPHONE_STATE メッセージのLINEDEVSTATE_REINITまたはPHONESTATE_REINIT値を介した動的再構成が通知されます。