lineProxyMessage 函式 (tapi.h)
lineProxyMessage 函式是由已註冊的 Proxy 要求處理程式用來產生與其角色相關的 TAPI 訊息。 例如,ACD 代理程式處理程式可以使用這個函式來產生所有已開啟指定行的應用程式所收到的 LINE_AGENTSTATUS 訊息。 TAPI 會抑制在函式參數中指定的 hLine 上產生訊息。
語法
LONG lineProxyMessage(
HLINE hLine,
HCALL hCall,
DWORD dwMsg,
DWORD dwParam1,
DWORD dwParam2,
DWORD dwParam3
);
參數
hLine
開啟行裝置的句柄。 TAPI 會針對接收訊息的每個應用程式,將它轉換成正確的 hLine 。
hCall
如果訊息與特定呼叫 (無關,則LINE_AGENTSTATUS) 的情况下,指定 Proxy 處理程式的該呼叫句柄;對於與特定呼叫無關的訊息,應設定為 NULL 。 TAPI 會針對接收訊息的每個應用程式,將它轉換成正確的 hCall 。
dwMsg
要產生的 TAPI 訊息。 這必須是 Proxy 處理程式允許產生的訊息。
dwParam1
與要傳送之訊息相關聯的參數。
dwParam2
與要傳送之訊息相關聯的參數。
dwParam3
與要傳送之訊息相關聯的參數。
傳回值
如果函式成功或下列其中一個負誤差值,則傳回零:
LINEERR_INVALLINEHANDLE、LINEERR_INVALCALLHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_NOTREGISTERED、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |