lineUnparkW 函式 (tapi.h)

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

語法

LONG lineUnparkW(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCWSTR lpszDestAddress
);

參數

hLine

處理要取消鎖定呼叫的開啟線路裝置。

dwAddressID

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

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。

言論

注意

tapi.h 標頭會將 lineUnpark 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
目標平臺 窗戶
標頭 tapi.h
連結庫 Tapi32.lib
DLL Tapi32.dll

另請參閱

LINE_REPLY

補充線路服務函式

TAPI 2.2 參考概觀