lineGetStatusMessages 函式 (tapi.h)

lineGetStatusMessages 函式可讓應用程式查詢應用程式設定為接收哪些通知訊息，以取得與指定行或其位址之狀態變更相關的事件。

語法

LONG lineGetStatusMessages(
  HLINE   hLine,
  LPDWORD lpdwLineStates,
  LPDWORD lpdwAddressStates
);

hLine

線條裝置的句柄。

lpdwLineStates

識別要傳送訊息至應用程式的行裝置狀態變更的位數組。如果旗標為 TRUE，則會啟用該訊息;如果 為 FALSE，則會停用。此參數會使用一或多個 LINEDEVSTATE_常數。

lpdwAddressStates

識別要傳送訊息至應用程式的位址狀態變更的位數組。如果旗標為 TRUE，則會啟用該訊息;如果 為 FALSE，則為停用。此參數會使用一或多個 LINEADDRESSSTATE_常數。

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

TAPI 會定義一些訊息，以通知應用程式有關在行和位址上發生的事件。應用程式可能不想要接收所有位址和行狀態變更訊息。 lineSetStatusMessages 函式可用來選取應用程式想要接收的訊息。根據預設，地址狀態和行狀態報告會停用。