LINE_APPNEWCALL訊息
TAPI LINE_APPNEWCALL 訊息會傳送給應用程式，當新的呼叫控制碼是代表應用程式建立的 (，而不是透過來自應用程式的 API 呼叫，在此情況下，控制碼會透過傳遞至函式的指標參數傳回) 。
參數
-
hDevice
-
應用程式對已建立呼叫之線路裝置的控制碼。
-
dwCallbackInstance
-
開啟呼叫行時提供的回呼實例。
-
dwParam1
-
呼叫所在行上的位址識別碼。 位址識別碼永久與位址相關聯;識別碼在作業系統升級之間維持不變。
-
dwParam2
-
應用程式對新呼叫的控制碼。
-
dwParam3
-
新呼叫的應用程式許可權 (LINECALLPRIVILEGE_OWNER或LINECALLPRIVILEGE_MONITOR) 。
傳回值
沒有傳回值。
備註
支援 TAPI 2.0 版或更新版本的應用程式，每當應用程式在收到新呼叫控制碼時，都會傳送 LINE_APPNEWCALL 訊息。 由於訊息包含呼叫所在的 hLine 和 dwAddressID 參數，因此應用程式可以在正確的內容中立即建立新的呼叫物件。 LINE_APPNEWCALL訊息一律會緊接LINE_CALLSTATE訊息，指出呼叫的初始狀態。
繼承應用程式 (交涉早于 2.0) 的 API 版本，只會傳送 LINE_CALLSTATE 訊息，如舊版 API 中所述。 這類應用程式會在收到已將 dwParam3設定為非零值的LINE_CALLSTATE訊息，並包含應用程式目前不知道的呼叫控制碼時，建立新的呼叫物件。 缺點是 () 應用程式必須呼叫 lineGetCallInfo ，以判斷與呼叫相關聯的 hLine 和 dwAddressID 參數; (b) 應用程式必須掃描所有已知的呼叫控制碼，以判斷呼叫是新的呼叫;和 (c) 在某些情況下，應用程式可能會認為它正在收到新的呼叫控制碼，實際上它剛將其控制碼解除配置給呼叫 (，例如，應用程式剛解除配置呼叫控制碼，但 LINE_CALLSTATE 訊息會因為來自另一個應用程式的 lineHandoff 而獲得呼叫的擁有權，) 。
規格需求
| 需求 | 值 |
|---|---|
| TAPI 版本 |
需要 TAPI 2.0 或更新版本 |
| 標頭 |
|