TSPI_linePark 函数 (tspi.h)
TSPI_linePark函数根据指定的寄存模式来寄存指定的呼叫。
语法
LONG TSPIAPI TSPI_linePark(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
DWORD dwParkMode,
LPCWSTR lpszDirAddress,
LPVARSTRING lpNonDirAddress
);
参数
dwRequestID
异步请求的标识符。
hdCall
要寄存的调用的句柄。 hdCall 的呼叫状态可以连接。
dwParkMode
用于寄存呼叫的寄存模式，只有 一个LINEPARKMODE_常量。
lpszDirAddress
指向 以 null 结尾的 Unicode 字符串的指针，该字符串指示在使用定向寄存时要在其中寄存呼叫的地址。 地址采用可拨号地址格式。 对于非定向寄存，将忽略此参数。
lpNonDirAddress
指向 VARSTRING 类型的结构的指针。 对于非定向寄存，将在此结构中返回呼叫的寄存地址。 对于定向寄存，将忽略此参数。 在 VARSTRING 结构中，dwStringFormat 必须设置为STRINGFORMAT_ASCII (包含以 null 结尾的字符串的 ASCII 字符串缓冲区) ，并在 dwStringSize 中考虑终止 NULL。 如果 lpNonDirAddress 参数指向的内存对于请求的地址不够大， 则 TSPI_linePark 函数将返回LINEERR_STRUCTURETOOSMALL。
返回值
如果发生错误，则返回 dwRequestID 或错误号。 如果函数成功，相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。 可能的返回值如下所示：
LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALPARKMODE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL。
注解
VARSTRING 结构的所有成员（dwTotalSize 除外）都由服务提供商填充。 dwTotalSize 成员由 TAPI 填充，服务提供商不得覆盖此值。
在“定向寄存”下，通过 TAPI) (客户端应用程序指定要将呼叫寄存到的地址。 在“非定向寄存”下，交换机确定地址并将其提供给 TAPI。 在任一情况下，可以通过指定此地址来取消寄存呼叫。
寄存的呼叫通常在成功寄存后进入 空闲 呼叫状态。 服务提供商使用 LINE_CALLSTATE 消息报告新状态。 后续 TSPI_lineUnpark 会创建一个新的不同调用句柄，而不考虑 TSPI_lineCloseCall 是否已销毁旧句柄。
某些开关可以在呼叫已长时间保留后提醒用户。 服务提供商将此报告给 TAPI 作为 产品/服务 呼叫，呼叫原因设置为 提醒 (如果已知) 。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |