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 |