lineAddProvider 関数 (tapi.h)

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

lineAddProvider 関数は、テレフォニーシステムに新しいテレフォニーサービスプロバイダーをインストールします。

構文

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

パラメーター

lpszProviderFilename

へのポインター

追加するサービスプロバイダーのパスを含む null で終わる文字列。

hwndOwner

インストールプロセスの一部として表示する必要があるダイアログボックス (サービスプロバイダーの TSPI_providerInstall 関数など) がアタッチされるウィンドウを処理します。関数の間に作成されたウィンドウに所有者ウィンドウがないことを示すには 、NULL を 指定できます。

lpdwPermanentProviderID

新しくインストールされたサービスプロバイダーの永続的なプロバイダー識別子を受け取る変数へのポインター。

戻り値

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

LINEERR_INIFILECORRUPT、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_NOMULTIPLEINSTANCE、LINEERR_OPERATIONFAILED。

注釈

この関数呼び出し中に TAPI は、 TSPI_providerInstall 関数を呼び出してサービスプロバイダーにアクセスできることを確認します。これが失敗した場合 (DLL または関数が見つからない場合、または TSPI_providerInstall がエラーを返す場合)、関数は失敗し、プロバイダーはテレフォニーシステムに追加されません。これが成功し、テレフォニーシステムがアクティブな場合 (1 つ以上のアプリケーションで lineInitialize または lineInitializeEx が呼び出された場合)、TAPI は新しく追加されたサービスプロバイダーの起動を試みません。代わりに、新しいサービスプロバイダーをアクティブ化するために、TAPI は Windows を再起動するメッセージを発行します。アクティブ化が成功すると、アプリケーションは、メッセージのLINE_CREATE または PHONE_CREATE によって作成された新しいデバイス、または再初期化を要求する LINE_LINEDEVSTATE メッセージ (アプリケーションが CREATE メッセージをサポートしていない場合) によって作成されたすべてのデバイスを通知します。

この関数は、サービスプロバイダー DLL 自体やサポートファイルではなく、ファイルをコピーしません。プロバイダーの追加を管理するアプリケーションは、プロバイダーが TAPI によって見つかるディレクトリ (\WINDOWS、\WINDOWS\SYSTEM、パスの他の場所など) にインストールされていることを確認する必要があります。