TUISPI_providerGenericDialog, fonction (tspi.h)
La fonction TUISPI_providerGenericDialog dans la DLL d’interface utilisateur est appelée lorsque le fournisseur de services envoie un message LINE_CREATEDIALOGINSTANCE . Le fournisseur de services l’utilise pour créer des boîtes de dialogue dans le contexte de l’application conjointement avec le traitement de fonctions TSPI asynchrones particulières. Cette fonction est appelée à partir d’un thread créé spécifiquement pour afficher la boîte de dialogue. La DLL d’interface utilisateur ne retourne pas à partir de cette fonction tant que la boîte de dialogue n’est pas détruite.
L’implémentation est obligatoire si le fournisseur de services associé à la DLL d’interface utilisateur envoie LINE_CREATEDIALOGINSTANCE messages pour créer spontanément des boîtes de dialogue dans le contexte de l’application.
Syntaxe
LONG TSPIAPI TUISPI_providerGenericDialog(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
HTAPIDIALOGINSTANCE htDlgInst,
LPVOID lpParams,
DWORD dwSize,
HANDLE hEvent
);
Paramètres
lpfnUIDLLCallback
Pointeur vers une fonction que la DLL d’interface utilisateur peut appeler pour communiquer avec la DLL du fournisseur de services afin d’obtenir les informations nécessaires à l’affichage de la boîte de dialogue.
htDlgInst
Identificateur opaque liant l’association de cette instance de la fonction à une requête particulière du fournisseur de services. La DLL d’interface utilisateur doit inclure ce paramètre, ainsi que TUISPI_OBJECT_DIALOGINSTANCE, dans tout appel à TUISPIDLLCALLBACK pour demander des données supplémentaires au fournisseur de services ou les remettre.
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. En règle générale, ce bloc de paramètres contient toutes les informations dont la DLL d’interface utilisateur a besoin pour afficher initialement la boîte de dialogue.
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 .
hEvent
Handle vers un objet d’événement créé par TAPI. Cet événement est signalé par la DLL d’interface utilisateur via SetEvent (hEvent) lorsque la DLL d’interface utilisateur a terminé l’initialisation de cette boîte de dialogue instance et qu’elle est prête à recevoir des données de boîte de dialogue supplémentaires via TUISPI_providerGenericDialogData. Les données envoyées par le fournisseur de services associé (via LINE_SENDDIALOGINSTANCEDATA) pour cette boîte de dialogue instance sont bloquées par TAPI jusqu’à ce que la DLL d’interface utilisateur signale cet événement, ce qui TUISPI_providerGenericDialog la possibilité d’effectuer toute initialisation nécessaire. La DLL d’interface utilisateur doit signaler l’événement aussi rapidement que possible pour éviter de bloquer les appels à TUISPI_providerGenericDialogData.
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
| Plateforme cible | Windows |
| En-tête | tspi.h |