lineSetStatusMessages 函式 (tapi.h)
lineSetStatusMessages 函式可讓應用程式針對與指定行或任何位址的狀態變更相關的事件,指定要接收哪些通知訊息。
語法
LONG lineSetStatusMessages(
HLINE hLine,
DWORD dwLineStates,
DWORD dwAddressStates
);
參數
hLine
線條裝置的句柄。
dwLineStates
識別要傳送訊息給應用程式的行裝置狀態變更的位數組。 此參數使用一或多個 LINEDEVSTATE_常數。
dwAddressStates
識別要傳送訊息至應用程式的位址狀態變更的位數組。 此參數使用一或多個 LINEADDRESSSTATE_常數。
傳回值
如果要求成功,則傳回零,如果發生錯誤,則傳回負錯誤號碼。 可能的傳回值為:
LINEERR_INVALADDRESSSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINESTATE、LINEERR_UNINITIALIZED、LINEERR_NOMEM LINEERR_OPERATIONUNAVAIL。
備註
TAPI 會定義一些訊息,通知應用程式在行和位址上發生的事件。 應用程式可能不想要接收所有位址和行狀態變更訊息。 lineSetStatusMessages 函式可用來選取應用程式接收的訊息。 根據預設,位址和行狀態報告已停用。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |