TSPI_lineBlindTransfer関数 (tspi.h)
TSPI_lineBlindTransfer関数は、指定した宛先アドレスへの指定された呼び出しのブラインドまたはシングルステップ転送を実行します。
構文
LONG TSPIAPI TSPI_lineBlindTransfer(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
パラメーター
dwRequestID
非同期要求の識別子。
hdCall
転送する呼び出しに対するサービス プロバイダーのハンドル。 hdCall の呼び出し状態は接続できます。
lpszDestAddress
呼び出しの転送先を識別する null で終わる Unicode 文字列へのポインター。 宛先アドレスは、標準のダイヤル可能な番号形式を使用します。
dwCountryCode
宛先の国または地域コード。 実装では、これを使用して、宛先アドレスの呼び出し進行状況プロトコルを選択する必要があります。 値 0 を指定した場合、サービス プロバイダーは既定値を使用する必要があります。 TAPI は、この関数が呼び出されたときに dwCountryCode を検証しません。
戻り値
エラーが発生した場合は 、dwRequestID またはエラー番号を返します。 関数が成功した場合は対応するASYNC_COMPLETIONの lResult 実際のパラメーターは 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESS、LINEERR_OPERATIONFAILED、LINEERR_ADDRESSBLOCKED、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALCOUNTRYCODE。
注釈
サービス プロバイダーは、LINEERR_INVALADDRESSを返した場合、ダイヤルを実行しません。
ブラインド転送は、TAPI に対して相談呼び出しが表示されないという点で、コンサルテーション転送とは異なります。 通常、ブラインド転送が正常に完了すると、指定された呼び出しがオンになっていた行からクリアされ、 アイドル 状態に遷移します。 サービス プロバイダーの呼び出しハンドルは、転送が完了した後も有効なままである必要があります。 TAPI により、このハンドルは、 TSPI_lineCloseCallを使用して転送された呼び出しに関心がなくなったときに無効になります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |