lineConfigDialogA, fonction (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 les paramètres liés à l’appareil de ligne.

Syntaxe

LONG lineConfigDialogA(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Paramètres

dwDeviceID

Identificateur de l’appareil de ligne à configurer.

hwndOwner

Handle à une fenêtre à laquelle la boîte de dialogue doit être attachée. Peut être 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 demande réussit ou un nombre 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 applicables à 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, en passant « COMM » en tant que lpszDeviceClass , le fournisseur affiche les paramètres liés spécifiquement à Comm (ou, au moins, commencez au point correspondant dans une chaîne de boîte de dialogue de configuration à plusieurs niveaux, de sorte que l’utilisateur n’ait pas à « creuser » pour trouver les paramètres qui vous intéressent).

Le paramètre lpszDeviceClass serait « tapi/line », « » ou NULL pour que le fournisseur affiche la configuration de niveau le plus élevé pour la ligne.

Notes

L’en-tête tapi.h définit lineConfigDialog en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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

Vue d’ensemble de la référence TAPI 2.2

lineGetID