TSPI_lineUnpark函式 (tspi.h)

發行項
03/08/2023

TSPI_lineUnpark函式會擷取停在指定位址的呼叫，並傳回其呼叫控制碼。

語法

LONG TSPIAPI TSPI_lineUnpark(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HTAPICALL     htCall,
  LPHDRVCALL    lphdCall,
  LPCWSTR       lpszDestAddress
);

參數

dwRequestID

非同步要求的識別碼。

hdLine

呼叫要取消儲存之行的控制碼。

dwAddressID

在 hdLine上產生 unpark 的位址。位址識別碼會永久與位址相關聯;識別碼在作業系統升級期間會維持不變。呼叫此函式時，TAPI 不會驗證此參數。

htCall

新未限定呼叫的 TAPI 控制碼。服務提供者必須儲存此專案，並在呼叫上報告事件的所有後續 LINEEVENT 程式呼叫中使用它。

lphdCall

HDRVCALL的指標，表示新未鎖定呼叫的服務提供者識別碼。服務提供者必須以呼叫的控制碼填滿此位置，此程式才會傳回。如果函式產生錯誤，這個控制碼就無效。

lpszDestAddress

Null 終止 Unicode 字串的指標，其中包含呼叫的駐留位址。位址格式為可撥號位址。

傳回值

會傳回 dwRequestID，如果發生錯誤，則傳回錯誤號碼。如果函式成功，則對應ASYNC_COMPLETION的lResult實際參數為零，如果發生錯誤，則為錯誤號碼。可能的傳回值如下所示：

LINEERR_INVALLINEHANDLE、LINEERR_NOMEM、LINEERR_INVALPOINTER、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS LINEERR_RESOURCEUNAVAIL。

備註

此函式與對應的 TAPI 函式不同，因為它會遵循 TSPI 模型，以開始呼叫的存留期。 TAPI 和服務提供者交換不透明的控制碼，代表彼此的呼叫。此外，服務提供者可以在從這個程式傳回之前，先執行新呼叫的回呼。在任何情況下，服務提供者也必須將傳回的控制碼視為「無效」，直到比對 ASYNC_COMPLETION 訊息回報成功為止。換句話說，它不得針對新呼叫發出任何 LINEEVENT 訊息，或將它包含在該行的訊息或狀態資料結構中的呼叫計數中。

這個函式所建立的呼叫控制碼是新的、相異的呼叫控制碼，即使呼叫的原始呼叫控制碼仍然存在， (TSPI_lineCloseCall) 尚未終結它。