lineRemoveProvider 関数 (tapi.h)

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

lineRemoveProvider 関数は、テレフォニーシステムから既存のテレフォニーサービスプロバイダーを削除します。

構文

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

パラメーター

dwPermanentProviderID

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

hwndOwner

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

戻り値

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

LINEERR_INIFILECORRUPT、LINEERR_NOMEM、LINEERR_INVALPARAM、LINEERR_OPERATIONFAILED。

注釈

TSPI_providerRemoveへの呼び出しが成功し、その時点でテレフォニーシステムがアクティブな場合、TAPI はサービスプロバイダーで lineShutdown または phoneShutdown を呼び出します (アクティブなデバイスの種類に応じて)。関連付けられたデバイス上のアプリケーションによって引き続き保持されている回線または電話ハンドルは、 LINE_CLOSE メッセージまたは PHONE_CLOSE メッセージで強制的に閉じられます (サービスプロバイダーは、ユーザーとの検証後に、TSPI_providerRemoveの一部としてこれらのメッセージを発行することをお勧めします)。そのプロバイダーの制御下にある以前のデバイスは"使用不可" としてマークされるため、今後、アプリケーションがデバイス識別子で参照しようとすると、LINEERR_NODRIVER。