lineRedirect 関数 (tapi.h)

[アーティクル]
03/05/2024

lineRedirect 関数は、指定したオファリング呼び出しを指定した宛先アドレスにリダイレクトします。

構文

LONG lineRedirect(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

パラメーター

hCall

リダイレクトされる呼び出しへのハンドル。アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態はオファリングである必要があります。

lpszDestAddress

宛先アドレスへのポインター。これは、標準のダイヤル可能な番号形式に従います。

dwCountryCode

通話がリダイレクトされるパーティの国/地域コード。値 0 を指定した場合、実装では既定値が使用されます。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。対応するLINE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。可能な戻り値は次のとおりです。

LINEERR_INVALADDRESS、LINEERR_NOTOWNER、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALCOUNTRYCODE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

注釈

呼び出しリダイレクトを使用すると、アプリケーションは最初に呼び出しに応答することなく、オファリング呼び出しを別のアドレスに偏向できます。コールリダイレクトは、コール転送がアプリケーションの関与なしにスイッチによって実行されるという点でコール転送とは異なります。リダイレクトは、アプリケーションによって呼び出しごとに実行できます (たとえば、呼び出し元 ID 情報によって駆動されます)。通話転送とは異なり、通話を転送するには最初に通話に応答する必要があります。

呼び出しが正常にリダイレクトされると、通常、呼び出しはアイドル状態に遷移します。

アプリケーションには、着信呼び出しをリダイレクトするだけでなく、 lineAccept を使用して呼び出しを受け入れるか、 lineDrop を使用して呼び出しを拒否するか、 lineAnswer を使用して呼び出しに応答するかを選択できます。これらの操作の可用性は、デバイスの機能によって異なります。