fonction TSPI_lineConfigDialog (tspi.h)
La fonction TSPI_lineConfigDialog 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_lineConfigDialog.
La fonction TSPI_lineConfigDialog permet au fournisseur de l’appareil de ligne spécifié d’afficher une boîte de dialogue modale en tant que fenêtre enfant de hwndOwner pour permettre à l’utilisateur de configurer les paramètres liés à l’appareil de ligne.
Syntaxe
LONG TSPIAPI TSPI_lineConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Paramètres
dwDeviceID
Périphérique de ligne à configurer.
hwndOwner
Handle d’une fenêtre parente dans laquelle la fenêtre de boîte de dialogue doit être placée.
lpszDeviceClass
Pointeur vers une chaîne Unicode terminée par null qui identifie un nom de classe d’appareil. Cette classe d’appareil permet à l’appelant de sélectionner un sous-écran spécifique des informations de configuration applicables à cette classe d’appareil. Si ce paramètre a la valeur NULL ou une chaîne vide, la boîte de dialogue de configuration de niveau supérieur doit être sélectionnée. Les chaînes autorisées sont les mêmes que pour TSPI_lineGetID. Par exemple, si la ligne prend en charge l’API Comm, le passage de comm/datamodem en tant que lpszDeviceClass amène le fournisseur à afficher les paramètres liés spécifiquement à Comm (ou, au moins, à démarrer au point correspondant dans une chaîne de boîte de dialogue de configuration à plusieurs niveaux, afin que l’utilisateur n’ait pas à rechercher les paramètres souhaités.)
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_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Remarques
La procédure doit mettre à jour la section [Windows Telephony] dans le fichier Win.ini et diffuser le message WM_WININICHANGE si elle apporte des modifications au fichier Telephon.ini qui entraînerait une modification des fonctionnalités de ligne ou d’adresse signalées dans LINEDEVCAPS ou LINEADDRESSCAPS, ou si un appareil de ligne est créé ou supprimé.
Il n’existe aucune restriction selon laquelle cette fonction (TSPI_lineConfigDialog) doit être appelée uniquement lorsque la ligne est fermée. Toutefois, chaque fournisseur peut imposer une telle restriction lui-même. Lorsque TSPI_lineConfigDialog est appelé, le fournisseur peut alerter l’utilisateur avec le message « La ligne est utilisée par une ou plusieurs applications. Vous ne pouvez pas modifier la configuration de ligne lorsque la ligne est en cours d’utilisation » (et renvoyer le message d’erreur LINEERR_INUSE). Toutefois, certaines configurations peuvent être sécurisées pour changer « à la volée », en particulier celles liées aux types de médias (comme le protocole de contrôle d’erreur du modem), en particulier lorsque ce type de média n’est pas actuellement utilisé. Le fournisseur peut autoriser ces options à être modifiées lorsque la ligne est ouverte.
Les utilisateurs ne doivent pas être autorisés à modifier quoi que ce soit qui modifie les valeurs retournées avec LINEDEVCAPS ou LINEADDRESSCAPS sans d’abord fermer de force la ligne comme signal que les applications doivent appeler des fonctions qui retournent ces structures afin d’avoir des informations précises.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | tspi.h |