Share via

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

另請參閱

基本電話語音服務參考

LINE_CLOSE

LINE_LINEDEVSTATE

TAPI 2.2 參考概觀

lineInitialize

lineInitializeEx

lineOpen