lineAddProvider 関数は、テレフォニー システムに新しいテレフォニー サービス プロバイダーをインストールします。
構文
LONG lineAddProviderA(
LPCSTR lpszProviderFilename,
HWND hwndOwner,
LPDWORD lpdwPermanentProviderID
);
パラメーター
lpszProviderFilename
へのポインター
追加するサービス プロバイダーのパスを含む null-terminated 文字列を
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 または
この関数は、サービス プロバイダー DLL 自体やサポート ファイルではなく、ファイルをコピーしません。プロバイダーの追加を管理するアプリケーションは、プロバイダーが TAPI で見つかるディレクトリ (\WINDOWS、\WINDOWS\SYSTEM、パスの他の場所など) にインストールされていることを確認する必要があります。
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineAddProvider を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
lineInitializeEx を