lineRedirect 函式 (tapi.h)

發行項
03/02/2024

lineRedirect 函式會將指定的供應專案呼叫重新導向至指定的目的地位址。

語法

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

參數

hCall

要重新導向之呼叫的句柄。應用程式必須是呼叫的擁有者。 hCall 的呼叫狀態必須提供。

lpszDestAddress

目的地地址的指標。這會遵循標準可撥號號碼格式。

dwCountryCode

重新導向呼叫之合作對象的國家/地區代碼。如果指定值為 0，實作會使用預設值。

傳回值

如果函式是以異步方式完成，則傳回正要求標識碼，如果發生錯誤，則傳回負錯誤號碼。如果函式成功，則對應LINE_REPLY訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。可能的傳回值為：

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