fonction TSPI_providerConfig (tspi.h)
La fonction TSPI_providerConfig est obsolète. Les fournisseurs de services TAPI version 1.4 ou antérieure peuvent implémenter cette fonction TSPI. TAPI version 2.0 ou ultérieure implémentent TUISPI_providerConfig.
La fonction TSPI_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.
Syntaxe
LONG TSPIAPI TSPI_providerConfig(
HWND hwndOwner,
DWORD dwPermanentProviderID
);
Paramètres
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.
L’utilitaire téléphonie Panneau de configuration fourni avec La téléphonie Windows dans les versions 1.4 et antérieures appelle cette fonction lorsque la commande d’installation est appelée.
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 |