TUISPI_providerGenericDialogData-Funktion (tspi.h)
Die TUISPI_providerGenericDialogData-Funktion in der UI-DLL wird aufgerufen, wenn der Dienstanbieter eine LINE_SENDDIALOGINSTANCEDATA Nachricht sendet. Der Dienstanbieter verwendet dies, um Informationen in Dialogfeldern, die im Anwendungskontext in Verbindung mit der Verarbeitung bestimmter asynchroner TSPI-Funktionen erstellt wurden, spontan zu aktualisieren. Diese Funktion wird von einem separaten Thread aufgerufen, in dem TUISPI_providerGenericDialogData ausgeführt wird. Die UI-DLL sollte den Thread, in dem diese Funktion aufgerufen wird, nicht blockieren, sondern die Daten verarbeiten und sofort zurückgeben (ggf. eine Nachricht an das Dialogfeld senden).
Die Implementierung ist obligatorisch, wenn TUISPI_providerGenericDialog exportiert wird.
Syntax
LONG TSPIAPI TUISPI_providerGenericDialogData(
HTAPIDIALOGINSTANCE htDlgInst,
LPVOID lpParams,
DWORD dwSize
);
Parameter
htDlgInst
Der undurchsichtige Bezeichner, der die Zuordnung dieses instance der Funktion zu einer bestimmten Anforderung des Dienstanbieters bindet.
lpParams
Zeiger auf einen Speicherbereich, der zum Speichern eines Parameterblocks verwendet wird. Der Inhalt dieses Parameterblocks ist spezifisch für den Dienstanbieter und die zugehörige UI-DLL. Die Übermittlung von Daten über diesen Parameterblock ist eine einzige Möglichkeit für die UI-DLL. Änderungen, die am Parameterblock vorgenommen wurden, werden nicht im Dienstanbieter reflektiert. Wenn dieser Parameter auf NULL festgelegt ist, ist dies eine Anforderung, das Dialogfeld sofort zu schließen und sauber ( TUISPIDLLCALLBACK sollte während dieser Bereinigung nicht aufgerufen werden). TAPI ruft diese Funktion auf, wobei lpParams auf NULL festgelegt ist, um die Bereinigung des Dialogfelds unter bestimmten Umständen zu erzwingen, z. B. bei einer Anwendung , die lineShutdown aufruft , wobei ein Dialogfeld weiterhin aktiv ist.
dwSize
Die Größe des Parameterblocks in Bytes. Wenn der lpParams-Parameter ein Zeiger auf eine Zeichenfolge ist, muss die Größe den NULL-Abschlussator enthalten.
Rückgabewert
Gibt bei erfolgreicher Ausführung null oder einen der folgenden negativen Fehlerwerte zurück:
LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |