lineGetCallInfo 函式 (tapi.h)
lineGetCallInfo 函式可讓應用程式取得所指定呼叫的固定資訊。
語法
LONG lineGetCallInfo(
HCALL hCall,
LPLINECALLINFO lpCallInfo
);
參數
hCall
要查詢之呼叫的句柄。 hCall 的呼叫狀態可以是任何狀態。
lpCallInfo
LINECALLINFO 類型的可變大小數據結構的指標。 成功完成要求時，此結構會填入呼叫相關信息。 在呼叫 lineGetCallInfo之前，應用程式應該設定此結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。
傳回值
如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。 可能的傳回值為：
LINEERR_INVALCALLHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL。
備註
每個連入或傳出呼叫都有個別 的LINECALLINFO 結構。 結構主要包含有關呼叫的固定資訊。 當應用程式收到 LINE_CALLSTATE 訊息呼叫的句柄時，或每次收到呼叫信息結構部分已變更的訊息 LINE_CALLINFO 通知時，應用程式通常會想要檢查這項資訊。 這些訊息會提供呼叫的句柄做為參數。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |