TSPI_lineSetAppSpecific函式 (tspi.h)

TSPI_lineSetAppSpecific函式會設定所指定呼叫 LINECALLINFO 結構的應用程式特定欄位。

語法

LONG TSPIAPI TSPI_lineSetAppSpecific(
  HDRVCALL hdCall,
  DWORD    dwAppSpecific
);

參數

hdCall

要設定應用程式特定欄位之呼叫的句柄。 hdCall 的呼叫狀態可以是任何狀態。

dwAppSpecific

呼叫 LINECALLINFO 結構之 dwAppSpecific 成員的新內容。 服務提供者未解譯此值。 呼叫此函式時，TAPI 不會驗證此參數。

傳回值

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL LINEERR_OPERATIONUNAVAIL。

備註

電話語音 API 或其任何服務提供者未解譯每個呼叫之 LINECALLINFO 資料結構中的應用程式特定字段。 其使用方式完全由應用程式定義。 欄位可以從TSPI_lineGetCallInfo傳回的 LINECALLINFO 記錄讀取。 不過， TSPI_lineSetAppSpecific 必須用來設定字段，讓其他應用程式可以看到變更。 當此欄位變更時，服務提供者會傳送LINE_CALLINFO訊息，並指出 AppSpecific 欄位已變更。

規格需求

另請參閱

LINECALLINFO

LINE_CALLINFO

TSPI_lineGetCallInfo