Platform SDK: TAPI |
The TUISPI_providerGenericDialogData function in the UI DLL is called when the service provider sends a LINE_SENDDIALOGINSTANCEDATA message. The service provider uses this to spontaneously update information in dialog boxes created in the application context in conjunction with the processing of particular asynchronous TSPI functions. This function is called from a separate thread from that in which TSPI_providerGenericDialogData is executing. The UI DLL should not block the thread in which this function is called, but should process the data and return immediately (posting a message to the dialog box if necessary).
Implementation is mandatory if TUISPI_providerGenericDialog is exported.
LONG TSPIAPI TUISPI_providerGenericDialog( HTAPIDIALOGINSTANCE htDlgInst, LPVOID lpParams, DWORD dwSize );
Returns zero if successful, or one of these negative error values:
LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
Windows 95/98: Requires Windows 95 or later.
Version: Requires TAPI 2.0 or later.
Header: Declared in Tspi.h.
LINE_SENDDIALOGINSTANCEDATA, TUISPIDLLCALLBACK, lineShutdown