fonction lineConfigDialog (tapi.h)
La fonction lineConfigDialog permet au fournisseur de l’appareil de ligne spécifié d’afficher une boîte de dialogue (attachée à hwndOwner de l’application) pour permettre à l’utilisateur de configurer des paramètres liés à l’appareil de ligne.
Syntaxe
LONG lineConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Paramètres
dwDeviceID
Identificateur de l’appareil de ligne à configurer.
hwndOwner
Gérer à une fenêtre à laquelle la boîte de dialogue doit être attachée. Peut avoir la valeur NULL pour indiquer que toute fenêtre créée pendant la fonction ne doit avoir aucune fenêtre propriétaire.
lpszDeviceClass
Pointeur vers une chaîne terminée par null qui identifie un nom de classe d’appareil. Cette classe d’appareil permet à l’application de sélectionner un sous-écran spécifique d’informations de configuration applicables à cette classe d’appareil. Ce paramètre est facultatif et peut être laissé NULL ou vide, auquel cas la configuration de niveau le plus élevé est sélectionnée.
Valeur retournée
Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.
Remarques
La fonction lineConfigDialog permet au fournisseur de services d’afficher une boîte de dialogue modale (attachée à hwndOwner de l’application) pour permettre à l’utilisateur de configurer les paramètres liés à la ligne spécifiée par dwDeviceID. Le paramètre lpszDeviceClass permet à l’application de sélectionner un sous-écran spécifique d’informations de configuration applicable à la classe d’appareil qui intéresse l’utilisateur ; les chaînes autorisées sont les mêmes que pour lineGetID. Par exemple, si la ligne prend en charge l’API Comm, la transmission de « COMM » 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 d’une chaîne de boîte de dialogue de configuration à plusieurs niveaux, de sorte que l’utilisateur n’a pas à « creuser » pour trouver les paramètres qui vous intéressent).
Le paramètre lpszDeviceClass est « tapi/line », « » ou NULL pour que le fournisseur affiche la configuration de niveau le plus élevé pour la ligne.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi.h |
| Bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |
Voir aussi
Informations de référence sur les services de téléphonie de base