TSPI_providerGenericDialogData-Funktion (tspi.h)
Die TSPI_providerGenericDialogData-Funktion übermittelt die Daten des Dienstanbieters, die von der UI-DLL gesendet wurden, die in einem Anwendungskontext ausgeführt wird, über die FUNKTION TUISPIDLLCALLBACK . Der Inhalt des Speicherblocks, auf den von lpParams verwiesen wird, 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.
Die Implementierung ist obligatorisch, wenn die dem Dienstanbieter zugeordnete UI-DLL TUISPIDLLCALLBACK aufruft.
Syntax
LONG TSPIAPI TSPI_providerGenericDialogData(
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
dwObjectID ist ein Zeilengerätebezeichner (dwDeviceID).
TUISPIDLL_OBJECT_PHONEID
dwObjectID ist ein Telefongerätebezeichner (dwDeviceID)
TUISPIDLL_OBJECT_PROVIDERID
dwObjectID ist ein permanenter Anbieterbezeichner.
TUISPIDLL_OBJECT_DIALOGINSTANCE
dwObjectID ist eine HDRVDIALOGINSTANCE, die beim Senden einer LINE_CREATEDIALOGINSTANCE-Nachricht an den Dienstanbieter zurückgegeben wird.
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.
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
| Zielplattform | Windows |
| Kopfzeile | tspi.h |