TUISPI_providerInstall関数 (tspi.h)

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

TUISPI_providerInstall関数の実装は、プロバイダーの追加の "部分" を適切なディレクトリ (または少なくとも存在することを確認) にインストールし、プロバイダーが必要とするレジストリエントリを設定するサービスプロバイダーの機会です。この関数は、バージョン 2.0 以降 (バージョン 1.4 以前でサポートされています) でTSPI_providerInstall関数を廃止します。

サービスプロバイダーが適切な操作のためにレジストリ内のプライベート定義エントリを必要とする場合は、現時点でインストールする必要があります。

実装は省略可能です。

構文

LONG TSPIAPI TUISPI_providerInstall(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

パラメーター

lpfnUIDLLCallback

UI DLL が呼び出してサービスプロバイダー DLL と通信し、ダイアログボックスを表示するために必要な情報を取得できる関数へのポインター。

hwndOwner

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

dwPermanentProviderID

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

戻り値

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

LINEERR_OPERATIONFAILED、LINEERR_INIFILECORRUPT、LINEERR_NOMEM。 LINEERR_INVALPARAM。

注釈

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

この関数は、TUISPI_providerRemoveの呼び出しが発生するまで、サービスプロバイダーのインストール中に複数回呼び出すことができます。ただし、サービスプロバイダーがプロバイダーの複数のインスタンスを必要とせず、サポートしていない場合は、 LINEERR_定数 LINEERR_NOMULTIPLEINSTANCEが返されます。

TAPI レベルの対応する関数は lineAddProvider です。 LINE_CREATE メッセージは、動的再構成について実行されているアプリケーションに通知します。