TUISPI_providerGenericDialogData函式 (tspi.h)
當服務提供者傳送LINE_SENDDIALOGINSTANCEDATA訊息時,會呼叫UI DLL中的TUISPI_providerGenericDialogData函式。 服務提供者會使用此方法,在應用程式內容中建立的對話框中,與處理特定異步 TSPI 函式一起更新資訊。 此函式會從執行 TUISPI_providerGenericDialogData 的個別線程呼叫。 UI DLL 不應該封鎖呼叫此函式的線程,但應該處理數據,並在必要時 (將訊息張貼至對話框) 。
如果 導出TUISPI_providerGenericDialog ,則實作是必要的。
語法
LONG TSPIAPI TUISPI_providerGenericDialogData(
HTAPIDIALOGINSTANCE htDlgInst,
LPVOID lpParams,
DWORD dwSize
);
參數
htDlgInst
不透明標識符會將此函式實例的關聯繫結至服務提供者的特定要求。
lpParams
用來保存參數區塊的記憶體區域指標。 此參數區塊的內容專屬於服務提供者及其相關聯的 UI DLL。 透過此參數區塊傳達數據是UI DLL的單向;對參數區塊所做的變更不會反映在服務提供者中。 如果此參數設定為 NULL,這是立即關閉對話方塊的要求,而且在此清除) 期間不應叫用 ( TUISPIDLLCALLBACK 。 TAPI 會叫用此函式,並將 lpParams 設定為 NULL ,以在特定情況下強制清除對話方塊,例如呼叫 lineShutdown 且對話方塊仍在使用中的應用程式。
dwSize
參數區塊位元組的大小。 如果 lpParams 參數是字串的指標,大小必須包含 Null 終止符。
傳回值
如果成功,則傳回零,或下列其中一個負誤差值:
LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tspi.h |