TUISPIDLLCALLBACK-Rückruffunktion (tspi.h)

Artikel
08/26/2023

Die DllCallbackProc-Funktion wird von der UI-DLL aufgerufen, um einen privaten Parameterblock an den Dienstanbieter zu senden. Jeder Aufruf des Rückrufs führt zu einem Aufruf der TSPI_providerGenericDialogData-Funktion in dem Dienstanbieter, der dem angegebenen Objekt zugeordnet ist. Der Inhalt des Parameterblocks wird vom Dienstanbieter und der UI-DLL definiert. Der Dienstanbieter kann den Inhalt des Parameterblocks ändern. wenn diese Funktion zurückgibt, kopiert TAPI die geänderten Daten wieder in den ursprünglichen UI-DLL-Parameterblock.

Der TUISPIDLLCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. DllCallbackProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

TUISPIDLLCALLBACK Tuispidllcallback;

LONG Tuispidllcallback(
  DWORD_PTR dwObjectID,
  DWORD dwObjectType,
  LPVOID lpParams,
  DWORD dwSize
)
{...}

Parameter

dwObjectID

Ein Objektbezeichner des von dwObjectType angegebenen Typs.

dwObjectType

Eine der TUISPIDLL_OBJECT_ Konstanten, die den Typ des durch dwObjectID identifizierten Objekts angibt.

TUISPIDLL_OBJECT_LINEID

Der dwObjectID-Parameter ist ein Zeilengerätebezeichner (dwDeviceID). Dies wird verwendet, wenn der Rückruf während der Verarbeitung von TUISPI_lineConfigDialog oder TUISPI_lineConfigDialogEdit aufgerufen wird.

TUISPIDLL_OBJECT_PHONEID

Der dwObjectID-Parameter ist ein Telefongerätebezeichner (dwDeviceID). Dies wird verwendet, wenn der Rückruf während der Verarbeitung von TUISPI_phoneConfigDialog aufgerufen wird.

TUISPIDLL_OBJECT_PROVIDERID

Der dwObjectID-Parameter ist ein permanenter Anbieterbezeichner. Dies wird verwendet, wenn der Rückruf während der Verarbeitung von TUISPI_providerConfig, TUISPI_providerInstall oder TUISPI_providerRemove aufgerufen wird.

TUISPIDLL_OBJECT_DIALOGINSTANCE

Der dwObjectID-Parameter ist eine HDRVDIALOGINSTANCE, wie er an den Dienstanbieter zurückgegeben wird, wenn er eine LINE_CREATEDIALOGINSTANCE-Nachricht gesendet hat. Dies wird verwendet, wenn der Rückruf während der Verarbeitung von TUISPI_providerGenericDialog aufgerufen wird.

lpParams

Zeiger auf einen Speicherbereich, der zum Speichern eines Parameterblocks verwendet wird.

dwSize

Die Größe des Parameterblocks in Bytes.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema Speicherzuordnung .