TSPI_lineRedirect 関数 (tspi.h)

[アーティクル]
08/26/2023

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

構文

LONG TSPIAPI TSPI_lineRedirect(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

リダイレクトされる呼び出しへのハンドル。 hdCall の呼び出し状態は、オファリングである可能性があります。

lpszDestAddress

宛先アドレスを指定する null で終わる Unicode 文字列へのポインター。これは標準のリンク形式に従います。

dwCountryCode

通話がリダイレクトされる相手の国または地域コード。値 0 を指定した場合、実装では既定値が使用されます。このパラメーターは、この関数が呼び出されるときに TAPI によって検証されません。

戻り値

dwRequestID を返します。エラーが発生した場合はエラー番号を返します。関数が成功した場合は対応するASYNC_COMPLETIONの実際のパラメーター lResult は 0、エラーが発生した場合はエラー番号です。可能な戻り値は次のとおりです。

LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCOUNTRYCODE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS、LINEERR_RESOURCEUNAVAIL。

注釈

サービスプロバイダーは、LINEERR_INVALADDRESSを返した場合、呼び出しをリダイレクトしません。

この関数が呼び出されると、サービスプロバイダーは、最初に呼び出しに応答することなく、オファリング呼び出しを別のアドレスに偏向します。コールリダイレクトはコール転送とは異なりますコール転送はコール転送がコールステーションの関与なしでスイッチによって行われます;リダイレクトは、呼び出し元 ID 情報によって駆動されるなど、クライアントアプリケーションによって呼び出しごとに実行できます。通話転送とは異なり、通話を転送するには、最初に通話に応答する必要があります。

呼び出しが正常にリダイレクトされると、通常、呼び出しは アイドル状態に移行します。サービスプロバイダーは、 LINE_CALLSTATE メッセージを使用して新しい状態を示します。