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 |
Library | Tapi32.lib |
DLL | Tapi32.dll |