lineBlindTransfer 関数は、指定した呼び出しを指定した宛先アドレスに対してブラインドまたはシングルステップで転送します。
構文
LONG lineBlindTransferA(
HCALL hCall,
LPCSTR lpszDestAddress,
DWORD dwCountryCode
);
パラメーター
hCall
転送する呼び出しへのハンドル。 アプリケーションは、この呼び出しの所有者である必要があります。 hCall の呼び出し状態
lpszDestAddress
未定
dwCountryCode
宛先の国または地域コード。 これは、宛先アドレスの呼び出し進行状況プロトコルを選択するために実装によって使用されます。 値 0 を指定すると、サービス プロバイダーによって定義された既定の呼び出し進行状況プロトコルが使用されます。
戻り値
関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。 対応する LINE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALCALLHANDLE、LINEERR_INVALCOUNTRYCODE、LINEERR_INVALCALLSTATE、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONUNAVAIL、LINEERR_NOTOWNER、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALADDRESS、LINEERR_UNINITIALIZED、LINEERR_ADDRESSBLOCKED、LINEERR_OPERATIONFAILED。
備考
LINEERR_INVALADDRESSが返された場合、ダイヤルは行われません。
ブラインド転送は、相談の呼び出しがアプリケーションに表示されないという点で、コンサルテーション転送とは異なります。 ブラインド転送が正常に完了すると、通常、指定された呼び出しはアプリケーションの行からクリアされ、アイドル状態 状態に遷移します。
転送が完了した後も、アプリケーションの呼び出しハンドルは有効なままです。 アプリケーションは、転送された呼び出しに関心がなくなったときに、lineDeallocateCall を使用してハンドルの割り当てを解除する必要があります。
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineBlindTransfer を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
lineDeallocateCall を