TSPI_lineDrop 関数 (tspi.h)
TSPI_lineDrop関数は、指定した呼び出しを削除または切断します。 ユーザーとユーザーの情報は、必要に応じて通話切断の一部として送信できます。 この関数は、アプリケーションからいつでも呼び出すことができます。 TSPI_lineDropが返された場合、呼び出しはアイドル状態である必要があります。
構文
LONG TSPIAPI TSPI_lineDrop(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
パラメーター
dwRequestID
非同期要求の識別子。
hdCall
破棄する呼び出しに対するサービス プロバイダーのハンドル。 hdCall の呼び出し状態は、アイドル状態を除く任意の状態にすることができます。
lpsUserUserInfo
このポインターは、 dwSize が 0 以外の場合にのみ有効です。 呼び出し切断の一部としてリモート パーティに送信されるユーザーユーザー情報を含む null で終わる文字列へのポインターを指定します。 ユーザーとユーザーの情報を送信しない場合、このポインターは NULL です。 ユーザーとユーザーの情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS を参照してください)。
dwSize
lpsUserUserInfo のユーザー ユーザー情報のサイズ (バイト単位)。 lpsUserUserInfo が NULL の場合、dwSize は無視されます。
戻り値
エラーが発生した場合は 、dwRequestID またはエラー番号を返します。 関数が成功した場合は対応するASYNC_COMPLETIONの lResult 実際のパラメーターは 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_USERUSERINFOTOOBIG、LINEERR_OPERATIONUNAVAIL。
注釈
呼び出しの現在の状態で呼び出しの削除が許可されていない場合、サービス プロバイダーは LINEERR_INVALCALLSTATE を返します。
TSPI_lineDropを呼び出すときは、関連する呼び出しにも影響を受ける場合があります。 たとえば、電話会議を削除すると、参加しているすべての通話が削除される場合があります。 LINE_CALLSTATE メッセージは、呼び出し状態が影響を受けるすべての呼び出しに対して TAPI に送信されます。 通常、ドロップされた呼び出しは アイドル 状態に遷移します。 オファリング状態の呼び出しでTSPI_lineDropを呼び出すと、呼び出しが拒否されます。 すべての電話ネットワークでこの機能が提供されるわけではありません。
通話を破棄する場合は、転送または電話会議の確立中に確立された相談呼び出しで、 OnHoldPending 状態に置かれた元の通話が再接続され、通常は 接続された 通話状態に再び入ります。
TAPI には、ドロップ時にユーザーとユーザーの情報を送信するオプションがあります。 ユーザーとユーザーの情報を送信できる場合でも、ネットワークがこの情報をリモート パーティに配信する保証はありません。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |