TSPI_providerShutdown関数 (tspi.h)
TSPI_providerShutdown関数は、サービス プロバイダーをシャットダウンします。 サービス プロバイダーは、進行中のアクティビティをすべて終了し、割り当てたリソースをすべて解放します。
構文
LONG TSPIAPI TSPI_providerShutdown(
DWORD dwTSPIVersion,
DWORD dwPermanentProviderID
);
パラメーター
dwTSPIVersion
この関数が動作する必要がある TSPI 定義のバージョン。 呼び出し元は、特別な dwDeviceIDINITIALIZE_NEGOTIATIONでTSPI_lineNegotiateTSPIVersionまたはTSPI_phoneNegotiateTSPIVersionを使用して、サービス プロバイダーに対して受け入れられることが保証されているバージョンをネゴシエートできます。
dwPermanentProviderID
このパラメーターを使用すると、サービス プロバイダーは、サービス プロバイダーの複数のインスタンス間でシャットダウン中のインスタンスを特定できます。 パラメーターの値は、 TSPI_providerInit内の同じ名前のパラメーターで渡された値と同じです。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM。
解説
この関数の最後のペア呼び出しは、TSPI_lineNegotiateTSPIVersionまたはTSPI_phoneNegotiateTSPIVersion以外のTSPI_lineまたはTSPI_phoneでプレフィックスが付いた TSPI 関数の最後の呼び出しである必要があります。 これを保証するのは呼び出し元の責任です。
この関数は、特別な状況を除き、常に成功する必要があります。 ほとんどの呼び出し元は、発生したエラーを補正できないため、リターン コードを無視する可能性があります。 指定された戻り値は、他の何よりも開発診断目的のアドバイザリです。
TAPI には直接対応する関数はありません。 TAPI では、複数の異なる使用状況インスタンスを未処理にすることができます。"アプリケーション ハンドル" パラメーターを使用して、操作対象のインスタンスを識別します。 TSPI では、インターフェイス アーキテクチャでは、個別のサービス プロバイダーごとに 1 つの使用状況インスタンスのみがサポートされます。
要件
対象プラットフォーム | Windows |
ヘッダー | tspi.h |