Fonction de rappel TUISPIDLLCALLBACK (tspi.h)

Article
08/26/2023

La fonction DllCallbackProc est appelée par la DLL d’interface utilisateur pour envoyer un bloc de paramètres privés au fournisseur de services. Chaque appel du rappel entraîne un appel à la fonction TSPI_providerGenericDialogData dans le fournisseur de services associé à l’objet spécifié. Le contenu du bloc de paramètres est défini par le fournisseur de services et la DLL d’interface utilisateur. Le fournisseur de services peut modifier le contenu du bloc de paramètres ; lorsque cette fonction retourne, TAPI copie les données modifiées dans le bloc de paramètres DLL d’interface utilisateur d’origine.

Le type TUISPIDLLCALLBACK définit un pointeur vers cette fonction de rappel. DllCallbackProc est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

TUISPIDLLCALLBACK Tuispidllcallback;

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

Paramètres

dwObjectID

Identificateur d’objet du type spécifié par dwObjectType.

dwObjectType

Une des constantes TUISPIDLL_OBJECT_ , spécifiant le type d’objet identifié par dwObjectID

TUISPIDLL_OBJECT_LINEID

Le paramètre dwObjectID est un identificateur d’appareil de ligne (dwDeviceID). Il est utilisé lorsque le rappel est appelé pendant le traitement de TUISPI_lineConfigDialog ou de TUISPI_lineConfigDialogEdit.

TUISPIDLL_OBJECT_PHONEID

Le paramètre dwObjectID est un identificateur d’appareil téléphonique (dwDeviceID). Il est utilisé lorsque le rappel est appelé pendant le traitement de TUISPI_phoneConfigDialog.

TUISPIDLL_OBJECT_PROVIDERID

Le paramètre dwObjectID est un identificateur de fournisseur permanent. Il est utilisé lorsque le rappel est appelé pendant le traitement de TUISPI_providerConfig, TUISPI_providerInstall ou TUISPI_providerRemove.

TUISPIDLL_OBJECT_DIALOGINSTANCE

Le paramètre dwObjectID est un HDRVDIALOGINSTANCE, comme retourné au fournisseur de services lorsqu’il a envoyé un message LINE_CREATEDIALOGINSTANCE . Il est utilisé lorsque le rappel est appelé pendant le traitement de TUISPI_providerGenericDialog.

lpParams

Pointeur vers une zone de mémoire utilisée pour contenir un bloc de paramètres.

dwSize

Taille en octets du bloc de paramètres.

Note Si les paramètres de taille de la structure ne sont pas corrects, il est possible que les données soient remplacées. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique allocation de mémoire .