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 字元串緩衝區) ，而終止 NULL 會考慮 在 dwStringSize 中。 如果 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。
備註
除了 dwTotalSize 之外，VARSTRING 結構的所有成員都會由服務提供者填入。 dwTotalSize 成員會由 TAPI 填入，服務提供者不得覆寫此值。
在導向駐留下，用戶端應用程式 (透過TAPI) 指定其想要將通話停駐的位址。 在非目錄駐留下，切換會決定位址，並將此位址提供給TAPI。 不論是哪一種情況，都可以藉由指定此位址來取消停駐通話。
停駐通話通常會在成功駐留後進入 閒 置通話狀態。 服務提供者會使用 LINE_CALLSTATE 訊息報告新狀態。 後續 TSPI_lineUnpark 會建立新的相異呼叫句柄，不論 TSPI_lineCloseCall 是否已終結舊的句柄。
有些交換器可以在通話停駐一段時間后提醒使用者。 服務提供者會將此報告給 TAPI 作為供應 專案通話， 並將呼叫原因設定為 提醒 (如果已知) 。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |