TUISPI_providerGenericDialog-Funktion (tspi.h)
Die TUISPI_providerGenericDialog-Funktion in der UI-DLL wird aufgerufen, wenn der Dienstanbieter eine LINE_CREATEDIALOGINSTANCE Nachricht sendet. Der Dienstanbieter verwendet dies, um Dialogfelder im Anwendungskontext in Verbindung mit der Verarbeitung bestimmter asynchroner TSPI-Funktionen zu erstellen. Diese Funktion wird aus einem Thread aufgerufen, der speziell für die Anzeige des Dialogfelds erstellt wurde. Die UI-DLL wird erst von dieser Funktion zurückgegeben, wenn das Dialogfeld zerstört wird.
Die Implementierung ist obligatorisch, wenn der der UI-DLL zugeordnete Dienstanbieter LINE_CREATEDIALOGINSTANCE Nachrichten sendet, um Dialogfelder spontan im Anwendungskontext zu erstellen.
Syntax
LONG TSPIAPI TUISPI_providerGenericDialog(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
HTAPIDIALOGINSTANCE htDlgInst,
LPVOID lpParams,
DWORD dwSize,
HANDLE hEvent
);
Parameter
lpfnUIDLLCallback
Zeiger auf eine Funktion, die die UI-DLL aufrufen kann, um mit der Dienstanbieter-DLL zu kommunizieren, um Informationen abzurufen, die zum Anzeigen des Dialogfelds erforderlich sind.
htDlgInst
Der undurchsichtige Bezeichner, der die Zuordnung dieses instance der Funktion zu einer bestimmten Anforderung des Dienstanbieters bindet. Die UI-DLL muss diesen Parameter zusammen mit TUISPI_OBJECT_DIALOGINSTANCE in jedem Aufruf von TUISPIDLLCALLBACK enthalten, um weitere Daten vom Dienstanbieter anzufordern oder daten an den Dienstanbieter zu übermitteln.
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. Im Allgemeinen enthält dieser Parameterblock alle Informationen, die die UI-DLL benötigt, um das Dialogfeld zunächst anzuzeigen.
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.
hEvent
Behandeln sie ein von TAPI erstelltes Ereignisobjekt. Dieses Ereignis wird von der UI-DLL über SetEvent (hEvent) signalisiert, wenn die UI-DLL die Initialisierung dieses Dialogfelds instance abgeschlossen hat und bereit ist, zusätzliche Dialogfelddaten über TUISPI_providerGenericDialogData zu empfangen. Daten, die vom zugehörigen Dienstanbieter (über LINE_SENDDIALOGINSTANCEDATA) für dieses Dialogfeld gesendet werden, instance von TAPI blockiert werden, bis die UI-DLL dieses Ereignis signalisiert, sodass TUISPI_providerGenericDialog die Möglichkeit hat, eine erforderliche Initialisierung durchzuführen. Die UI-DLL sollte das Ereignis so schnell wie möglich signalisieren, um Aufrufe von TUISPI_providerGenericDialogData zu vermeiden.
Rückgabewert
Gibt bei erfolgreicher Ausführung null oder einen der folgenden negativen Fehlerwerte zurück:
LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |