TUISPI_providerGenericDialogData, fonction (tspi.h)
La fonction TUISPI_providerGenericDialogData dans la DLL d’interface utilisateur est appelée lorsque le fournisseur de services envoie un message LINE_SENDDIALOGINSTANCEDATA . Le fournisseur de services l’utilise pour mettre à jour spontanément les informations dans les boîtes de dialogue créées dans le contexte de l’application en conjonction avec le traitement de fonctions TSPI asynchrones particulières. Cette fonction est appelée à partir d’un thread distinct de celui dans lequel TUISPI_providerGenericDialogData s’exécute. La DLL d’interface utilisateur ne doit pas bloquer le thread dans lequel cette fonction est appelée, mais doit traiter les données et retourner immédiatement (en publiant un message dans la boîte de dialogue si nécessaire).
L’implémentation est obligatoire si TUISPI_providerGenericDialog est exporté.
Syntaxe
LONG TSPIAPI TUISPI_providerGenericDialogData(
HTAPIDIALOGINSTANCE htDlgInst,
LPVOID lpParams,
DWORD dwSize
);
Paramètres
htDlgInst
Identificateur opaque liant l’association de cette instance de la fonction à une requête particulière du fournisseur de services.
lpParams
Pointeur vers une zone de mémoire utilisée pour contenir un bloc de paramètres. Le contenu de ce bloc de paramètres est spécifique au fournisseur de services et à sa DLL d’interface utilisateur associée. Le transfert des données via ce bloc de paramètres est unidirectionnel vers la DLL d’interface utilisateur ; Les modifications apportées au bloc de paramètres ne sont pas répercutées dans le fournisseur de services. Si ce paramètre est défini sur NULL, il s’agit d’une demande de fermeture immédiate de la boîte de dialogue et de propre ( TUISPIDLLCALLBACK ne doit pas être appelé pendant ce nettoyage). TAPI appelle cette fonction avec lpParams défini sur NULL pour forcer le nettoyage de la boîte de dialogue dans certaines circonstances, par exemple une application appelant lineShutdown avec une boîte de dialogue toujours active.
dwSize
Taille en octets du bloc de paramètres. Si le paramètre lpParams est un pointeur vers une chaîne, la taille doit inclure la marque de fin Null .
Valeur retournée
Retourne zéro en cas de réussite, ou l’une de ces valeurs d’erreur négatives :
LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |