lineDrop 関数 (tapi.h)
lineDrop 関数は、指定された呼び出しを破棄または切断します。 アプリケーションには、通話切断の一部として送信するユーザーとユーザーの情報を指定するオプションがあります。
構文
LONG lineDrop(
HCALL hCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
パラメーター
hCall
破棄する呼び出しを処理します。 アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態は、アイドル状態を除く任意の状態にすることができます。
lpsUserUserInfo
呼び出し切断の一部としてリモート パーティに送信されるユーザーとユーザーの情報を含む文字列へのポインター。 ユーザーとユーザーの情報を送信しない場合は、このポインターを NULL のままに できます。 ユーザーユーザー情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS を参照)。 必要に応じて、ユーザーユーザー情報のプロトコル識別子フィールドは lpsUserUserInfo によって指されるバッファーの最初のバイトとして表示され、 dwSize では を考慮する必要があります。
dwSize
lpsUserUserInfo 内のユーザーユーザー情報のサイズ (バイト単位)。 lpsUserUserInfo が NULL の場合、ユーザーユーザー情報は呼び出し元に送信されません。dwSize は無視されます。
戻り値
関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。 対応するLINE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_NOTOWNER、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_USERUSERINFOTOOBIG、LINEERR_INVALCALLSTATE、LINEERR_UNINITIALIZED。
注釈
lineDrop を呼び出すと、関連する呼び出しにも影響を受ける場合があります。 たとえば、電話会議を削除すると、参加しているすべての通話を削除できます。 LINE_CALLSTATE メッセージは、呼び出し状態が影響を受けるすべての呼び出しに対してアプリケーションに送信されます。 通常、ドロップされた呼び出しは アイドル 状態に遷移します。 オファリング状態の呼び出しで lineDrop を呼び出すと、呼び出しが拒否されます。 すべての電話ネットワークでこの機能が提供されるわけではありません。
保留 状態の 呼び出しは、通常、 接続 状態に戻ります。 電話会議のために第三者へのコンサルテーション コールを削除するとき、または以前に確立された電話会議で第三者を削除する場合、プロバイダー (およびスイッチ) は会議ブリッジを解放し、通話を通常の 2 者通話に戻すことができます。 この場合、 hConfCall は アイドル 状態に遷移し、残りの唯一の参加している呼び出しは 接続 状態に遷移します。 一部のスイッチでは、もう一方の呼び出しが自動的に "保留" されます。
アプリケーションには、ドロップ時にユーザーとユーザーの情報を送信するオプションがあります。 ユーザーとユーザーの情報を送信できる場合でも、ネットワークがこの情報をリモート パーティに配信する保証はありません。
複数のパーティが呼び出し中の場合、さまざまなブリッジまたはパーティ回線の構成では、 lineDrop が実際に通話をクリアしない可能性があります。 たとえば、ブリッジされた状況では、コール上の他のステーションのステータスが制御される可能性があるため、 lineDrop 操作が実際にコールをドロップしない可能性があります。代わりに、他のステーションで 接続 されたままの場合は、呼び出しを単にLINECONNECTEDMODE_INACTIVE モードに変更できます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | tapi.h |
Library | Tapi32.lib |
[DLL] | Tapi32.dll |