TSPI_lineSetStatusMessages函式 (tspi.h)

發行項
03/13/2024

TSPI_lineSetStatusMessages函式可讓 TAPI 指定服務提供者針對指定行或其任何位址之狀態變更相關的事件所應產生的通知訊息。

語法

LONG TSPIAPI TSPI_lineSetStatusMessages(
  HDRVLINE hdLine,
  DWORD    dwLineStates,
  DWORD    dwAddressStates
);

參數

hdLine

要設定新篩選之行裝置的句柄。

dwLineStates

位數組，識別要傳送訊息至TAPI的行裝置狀態變更。此參數使用其中一個 LINEDEVSTATE_常數。

dwAddressStates

位數組，識別要傳送至TAPI的位址狀態變更訊息。此參數會使用其中一個 LINEADDRESSSTATE_常數。

傳回值

如果函式成功，則傳回零，如果發生錯誤，則傳回錯誤號碼。可能的傳回值如下所示：

LINEERR_INVALADDRESSSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALLINESTATE、LINEERR_RESOURCEUNAVAIL LINEERR_NOMEM。

備註

如果 dwLineStates 參數包含一或多個不是 LINEDEVSTATE_常數的位，則服務提供者會傳回LINEERR_INVALLINESTATE。

電話語音會定義一些訊息，以通知應用程式有關線路和位址上發生的事件。所有應用程式感興趣的所有變更訊息集合可能小於一組可能的訊息。此程式可讓 TAPI 告訴服務提供者要傳遞的訊息集減少。服務提供者在指定的集合內傳遞它支援的所有訊息。基於效能考慮，允許傳遞更多 (TAPI) 篩選掉它們，但不建議這麼做。如果 TAPI 要求傳遞提供者未產生的特定訊息類型，提供者仍接受要求，但只會產生訊息。根據預設，一行的位址和行狀態報告一開始會停用。

此函式與對應的 TAPI 函式不同，如下所示： (1) 所要求的訊息集是 TAPI 層級應用程式所要求的所有集合的聯集。 (2) 訊息集不會因為 TSPI 層級) (3) ) (3 的 (擁有權概念而減少或擴增訊息集，因為服務提供者至少需要轉送指定的訊息集，但允許轉送較大的集合。

不會報告有關 Open 和 Close 的裝置狀態變更，因為 TSPI 層級一次只有一個未完成的 Open。