lineSetAppSpecific 函式 (tapi.h)

發行項
03/02/2024

lineSetAppSpecific 函式可讓應用程式設定指定呼叫呼叫資訊記錄的應用程式特定字段。

語法

LONG lineSetAppSpecific(
  HCALL hCall,
  DWORD dwAppSpecific
);

參數

hCall

處理需要設定應用程式特定欄位的呼叫。應用程式必須是呼叫的擁有者。 hCall 的呼叫狀態可以是任何狀態。

dwAppSpecific

呼叫之 LINECALLINFO 結構之 dwAppSpecific 成員的新內容。電話語音 API 不會解譯此值。

傳回值

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

LINEERR_INVALCALLHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_NOTOWNER、LINEERR_OPERATIONUNAVAIL LINEERR_OPERATIONFAILED。

備註

LINECALLINFO 數據結構中存在每個呼叫的應用程式特定欄位不會由 Telephony API 或其任何服務提供者解譯。其使用方式完全由應用程式定義。您可以從lineGetCallInfo傳回的LINECALLINFO記錄讀取欄位。不過， lineSetAppSpecific 必須用來設定字段，讓其他應用程式可以看到變更。當此欄位變更時，具有呼叫句柄的其他所有應用程式都會傳送LINE_CALLINFO訊息，並指出 dwAppSpecific 成員已變更。