lineUnpark 函式 (tapi.h)

  • 發行項

lineUnpark 函式會擷取停在指定位址的呼叫，並傳回其呼叫句柄。

語法

LONG lineUnpark(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCSTR  lpszDestAddress
);

參數

hLine

要取消鎖定呼叫的開啟行裝置句柄。

dwAddressID

要產生 unpark 之 hLine 上的位址。 位址標識符會永久與地址相關聯;標識碼在操作系統升級期間會維持不變。

lphCall

HCALL 類型位置的指標，其中會傳回未鎖定呼叫的句柄。 這個句柄與先前可能已經與擷取呼叫相關聯的任何其他句柄無關，例如原本駐留時可能已經與呼叫相關聯的句柄。 應用程式是此呼叫的初始唯一擁有者。

lpszDestAddress

Null 終止字元緩衝區的指標，其中包含停止呼叫的位址。 位址是標準可撥號位址格式。

傳回值

如果函式是以異步方式完成，則傳回正要求標識碼，如果發生錯誤，則傳回負錯誤號碼。 如果函式成功，則對應LINE_REPLY訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。 可能的傳回值為：

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

規格需求

需求 值
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

LINE_REPLY

增補行服務函式

TAPI 2.2 參考概觀