TSPI_phoneConfigDialog, fonction (tspi.h)
La fonction TSPI_phoneConfigDialog 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_phoneConfigDialog.
La fonction TSPI_phoneConfigDialog permet au fournisseur de l’appareil téléphonique 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 téléphonique.
Syntaxe
LONG TSPIAPI TSPI_phoneConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Paramètres
dwDeviceID
Appareil téléphonique à configurer.
hwndOwner
Handle vers 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 d’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 est sélectionnée.
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 :
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.
Remarques
TSPI_phoneConfigDialog amène le fournisseur de services à 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 au téléphone spécifié par dwDeviceID. Le paramètre lpszDeviceClass permet à l’application de sélectionner un sous-écran spécifique d’informations de configuration applicables à la classe d’appareil qui intéresse l’utilisateur. Les chaînes autorisées sont les mêmes que pour TSPI_phoneGetID. Par exemple, si le téléphone 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 à effectuer de recherche pour trouver les paramètres souhaités). Le paramètre szDeviceClass doit être « tapi/phone », « » ou NULL pour que le fournisseur affiche la configuration de niveau le plus élevé pour le téléphone.
La procédure doit mettre à jour la section [Téléphonie Windows] dans le fichier Win.ini et diffuser le message WM_WININICHANGE s’il apporte des modifications à Telephon.ini qui affectent le contenu des structures visibles pour les applications (telles que PHONECAPS), ou si des appareils téléphoniques sont créés ou supprimés.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |