fonction TUISPI_providerConfig (tspi.h)
La fonction TUISPI_providerConfig implémente les éléments d’interface utilisateur qui doivent s’exécuter dans le contexte de l’application appelante. Cette fonction rend la fonction TSPI_providerConfig obsolète dans les versions 2.0 et ultérieures (prises en charge dans les versions 1.4 et antérieures).
La fonction TUISPI_providerConfig collecte les informations de configuration de l’utilisateur. Il peut utiliser une boîte de dialogue, et cette boîte de dialogue peut inclure des sous-boîtes de dialogue associées à d’autres API (telles que Comm/datamodem) pour la configuration d’appareils spécifiques.
L’implémentation est facultative.
Syntaxe
LONG TSPIAPI TUISPI_providerConfig(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
HWND hwndOwner,
DWORD dwPermanentProviderID
);
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 et à l’envoi de la configuration mise à jour au fournisseur de services.
hwndOwner
Handle de la fenêtre parente dans laquelle la fonction peut créer toutes les fenêtres de boîte de dialogue requises pendant la configuration.
dwPermanentProviderID
Identificateur de fournisseur permanent du fournisseur de services.
Valeur retournée
Retourne zéro si la fonction réussit ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_OPERATIONFAILED, LINEERR_NOMEM.
Remarques
Cette fonction peut être appelée lorsque le fournisseur de services est en cours d’utilisation (c’est-à-dire entre les appels de TSPI_providerInit et TSPI_providerShutdown).
Toutes les modifications qui affectent le comportement visible via TSPI ne doivent prendre effet que lorsque le fournisseur de services est redémarré au TSPI_providerInit suivant.
Il n’existe aucune fonction correspondant directement au niveau TAPI. Dans TAPI, les applications ont accès à la ligne de fonctionsConfigDialog et phoneConfigDialog, qui permettent la configuration des paramètres d’une ligne ou d’un téléphone particulier une fois qu’il a été installé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |