TSPI_phoneClose 関数 (tspi.h)
TSPI_phoneClose関数は、デバイスで未処理のすべての非同期操作を完了または中止した後、指定された開いている電話デバイスを閉じます。
構文
LONG TSPIAPI TSPI_phoneClose(
HDRVPHONE hdPhone
);
パラメーター
hdPhone
閉じる電話に対するサービス プロバイダーの不透明なハンドル。 電話が正常に閉じられると、このハンドルは無効になります。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_RESOURCEUNAVAIL。
解説
サービス プロバイダーは、すべての非同期操作の完了を報告する必要があります。 未処理の非同期操作がある電話に対してこのプロシージャが呼び出された場合、このプロシージャが戻る前に、操作が適切な結果またはエラー コードで完了したと報告する必要があります。 一般に、TAPI は、これらが順番に完了するまで待機します。 ただし、サービス プロバイダーは、"中止" または "緊急シャットダウン" の状況で TSPI_phoneClose への早期呼び出しを処理するように準備する必要があります。
この手順が返された後、サービス プロバイダーは電話でそれ以上のイベントを報告する必要はありません。 電話のサービス プロバイダーの不透明なハンドルが無効になります。
サービス プロバイダーは、電話が開いている間に予約した非共有リソースを放棄する必要があります。 たとえば、comm ポートとモデムを介してアクセスされた電話を閉じると、comm ポートが閉じられ、他のアプリケーションで使用できるようになります。
特別な状況を除き、この関数は常に成功するはずです。 ほとんどの呼び出し元は、発生したエラーを補正できないため、リターン コードを無視する可能性があります。 指定された戻り値は、開発診断の目的で、他の何よりもアドバイザリです。
必要条件
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |